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Введение 


В современном мире, где как грибы после дождя появляются все новые и 
новые языки программирования, многие люди наивно причисляют себя 
к программистам, владея одним или двумя популярными скриптовыми ими- 
таторами. К ним я отношу, в первую очередь, такие, как У1виа! Ваз, С# и 
им подобные. Ни в коем случае не принижая высокий уровень интеграции 
и удобства данных языков, при всем желании не могу их поставить в один 
ряд с С, С++ и, тем более, с АззетЫег. И если в первом случае простота и 
легкость написания кода приводят к стандартным программам (клонам) и 
раздутым дистрибутивам, то во втором все зависит от фантазии и мастерст- 
ва программиста. Конечно, мне могут возразить. что сегодня решающим 
фактором является время, а не дисковое пространство, но и это составляет 
всего лишь часть всей правды. Гораздо более важным моментом следует 
считать надежность и переносимость программного обеспечения. Хорошо 
конечно, что есть такая операционная система, как \/Мп4о\$, под которую 
писать программы легко и удобно. А если ее не станет или она полностью 
изменит свою структуру, а фирма М!сгозой в очередной раз "порекомендует" 
изучить новый скриптовый язык? Разработчикам ничего не останется, как 
последовать рекомендациям или же, наконец, перейти па полноценный 
язык программирования. Одним словом, можно сколько угодно гадать 
о будущем, но оно от этого ничуть не изменится, поэтому изучайте С или 
С++, не думая о завтрашнем дне. 


Книга, которую вы держите в руках, ориентирована на тех, кто любит и це- 
нит С++ и АззетЫег, кто, несмотря на все заманчивые "предложения" ве- 
лущих поставщиков программных средств разработки, выбирает гибкость, 
мошь и безграничность полета фантазии. Весь представленный материал 
логически разделен на две части: программирование аппаратного обеспече- 
ния и общее программирование в операционных системах \!/140\5. При 
этом учитываются и самые новые версии УМтдо\з, и несправедливо уста- 
ревшие. 
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Часть Г полностью посвящена программированию базовых компонентов 
любого персонального компьютера: мыши, клавиатуры, процессора, сис- 
темных устройств, дисковой подсистемы, мониторинга питания и темпера- 
тур, видео и звука. Рассматриваются базовые методы программирования 
данных устройств — посредством набора функций ВОЗ и прямого доступа 
через порты ввода-вывода. Уделено должное внимание и программному ин- 
терфейсу \\!т32. Все примеры представлены как на языке АззетЫет, так и 
на С++, где это возможно. 


Часть И книги содержит очень компактный материал по основным вопро- 
сам программирования в \!194о\5. Рассматриваются наиболее важные и 
востребованные темы: элементы управления, системная оболочка, работа с 
файлами, Интернет, почта, сеть. Весь этот материал рассчитан на достаточ- 
но опытных программистов, имеющих представление о разработке про- 
грамм под \М!пдо\5. Практически все примеры написаны на чистом \!1132 
АРТ, и только некоторые в силу больших размеров используют классы из 
библиотеки МЕС. В последней главе собрано несколько интересных воз- 
можностей, логически не вошедших в другие разделы книги и, тем не ме- 
нее, имеющие большой практический интерес. 


Программные требования 


Для написания и отладки примеров были использованы оболочки \У15иа| 
С++ 6.0 и Войапа Тио АззетЫег 5.0 (ТАЗМ). Программисты, работающие 
в Убпа: С++ МЕТ, также могут без проблем выполнять представленные 
в книге примеры. 


Тестирование проводилось в операционных системах \/14о\$ МЕ и Ут- 
Ч4о\5 2000. Возникающие проблемы из-за различий в версиях учтены и вы- 
делены при рассмотрении материала. 


Поддержка 


В книге приведено болышое количество исходных кодов, размеры которых 
иногла превышают разумно допустимые для ручного ввода, поэтому читате- 
ли могут скопировать их с прилагаемого к книге диска или скачать прямо 
из Интернета по указанным ниже адресам. Кроме того, для программирова- 
ния оборудования рекомендуется ‘использовать драйверы, разработанные 
автором специально для читателей книги. Хочу подчеркнуть, что драйверы 
представлены исключительно для выполнения примеров из книги и не 
должны применяться как-либо иначе. Возникающие вопросы и замечания 
направляйте, пожалуйста, на е-та!: Котагоука@гатЫег.га. Скачать примеры 
и обновленные драйверы можно по следующим адресам: В р://а$р!32.пагод.ги 
и Вр: //Лагдореп.паго@.ги. 
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ГЛАВА 1 


Общие сведения 


Прежде чем начинать программирование устройств в операционных систе- 
мах семейства \Мш9о\$, необходимо разобраться в основных принципах 
доступа к аппаратной части компьютера под этими системами. А они, 
к большому сожалению, довольно скудны и однообразны. Существуют как 
минимум четыре официальных способа прямого доступа к оборудованию. 


1. Первый заключается в обычном использовании набора функции ввода- 
вывода: _обёр, _очери, _омера, _1пр, _1прм, _1тря. Они входят в состав 
библиотеки времени выполнения, но их применение очень сильно зави- 
сит от операционной системы. Практически все современные системы 
УЛпао\5 не позволяют работать с этими функциями в свободном ре- 
жиме. 


2. Второй способ базируется на применении универсальной функции вво- 
да-вывода реузсетоСопехго1. Основное преимущество при ее использова- 
нии заключается в однозначной поддержке данной функции всеми сис- 
темами \УМш4до\5, начиная с УМшдо\ 95 и заканчивая одной из послел- 
них — \\М дом 5ВЗ. Но у этой функции есть и серьезный недостаток — 
очень ограниченный диапазон применения. Несмотря на то, что она 
позволяет работать с дисковой системой и с современными интерфейса- 
ми передачи данных, получить прямой доступ к устройствам с ее по- 
мощью не удастся. 


3. Третий способ заключается в банальном создании драйвера (например, 
виртуального драйвера устройства), что позволяет получить неограни- 
ченный доступ ко всем устройствам в системе. Кроме того, данный вари- 
ант прекрасно будет работать во всех операционных системах \У/тдо\5. 
Основной недостаток этого метода заключается в относительной сложно- 
сти написания самого драйвера, а также необходимость создания отдель- 
ного варианта драйвера для каждой операционной системы. Например, 
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если программа написана под \Мшао\5 98 и Утдо\з 2000, то придется 
писать два разных драйвера под каждую систему. 


4. Последний способ заключается в использовании встроенного в У\У15иа1 
С++ макроассемблера. Он не позволяет применять прерывания (\УМт4о\$ 
будет "зависать"), но вполне неплохо работает с аппаратными портами. 


Поскольку каждый из перечисленных способов заслуживает внимания, раз- 
берем их подробнее. Сразу замечу, что выбор одного из представленных ва- 
риантов будет зависеть в первую очередь от версии операционной системы, 
а уж затем от решаемых программистом задач. И с этим ничего не подела- 
ешь, т. к. фирма Мсгозой с каждым годом все меньше и меньше оставляет 
возможностей прямого доступа к устройствам. С одной стороны, их можно 
понять, поскольку эти меры повышают общую надежность системы, но, 
с другой стороны, блокируют развитие конкурентного и часто более качест- 
венного программного обеспечения. Как я уже говорил, сначала мы разбе- 
рем официальные возможности, а затем рассмотрим существование альтер- 
нативного варианта. 


1.1. Использование функций ввода-вывода 


Существуют шесть функций для работы с портами. Три из них используют- 
ся для вывода, а три — для ввода данных. К функциям чтения данных отно- 
сятся: 


СЗ пр — позволяет считать один байт из указанного порта; 
С пр — позволяет прочитать одно слово из указанного порта; 
С :тра — позволяет прочитать двойное слово из указанного порта. 


Все эти функции имеют один аргумент, который должен указывать номер 
порта, из которого будут прочитаны данные. В зависимости от размера по- 
лучаемых данных нужно применять ту или иную функцию. В листинге 1.1 
показано, как можно работать с этими функциями. Максимальное значение 
адресуемого порта ограничено числом 65 535, которого вполне достаточно 
для работы со всеми существующими в системе значениями. 


// подключаем необходимый файл определений 

ф1ос1аде <соп1о.В> 

// прочитаем значение базовой памяти в килобайтах 

116 Се ВазеМемогу () 

{ 
// объявляем переменные для получения младшего и старшего байтов 
ВУТЕ 1омВазе = 0, р1орВазе = 0; 


Глава 1. Общие сведения 17 


// читаем информацию`из СМО$-памяти 
_омЕр ( 0х70, 0х15); // записываем номер первого регистра 
1оВазе = пр ( 0х71); // читаем младший байт 
_омЕр ( 0х70, 0х16); // записываем номер второго регистра 
В19ЪВазе = _1пр ( 0х71); // читаем старший байт 
// возвращаем размер базовой памяти в килобайтах 
гебагп .( ( В1аНВазе << 8) | 1омВазе); 
} 
// напишем функцию для управления клавиатурой 
у01А КеуВоага ОпОЕЕ ( роо1 БОЕЕ) 
{ 
ВУТЕ зтабе; // текущее состояние 
1Е ( БОЕЕ) // выключить клавиатуру 
{ 
// получаем текущее состояние 
зТафе = 1пр ( 0х61); 
// устанавливаем бит 7 в 1 
збасе |= 0х80; 
// записываем обновленное значение в порт 
_©очёр ( 0х%61, зфафе); 
} 
е1зе // включить клавиатуру 
и 
// получаем текущее состояние 
бабе = _1пр ( 0х61); 
// устанавливаем бит 7 в 0 
зрабе &= 0х7Е; 
// записываем обновленное значение в порт 
_омЕр { 0х61, зфафе); 
} 


Функции записи в порт имеют два аргумента. Первый позволяет указать 
номер порта, а второй служит для хранения передаваемых данных. К функ- 
циям записи данных относятся: 


О озёр — позволяет записать один байт в указанный порт; 
О стёр“ — позволяет записать слово в указанный порт; 
О сора — позволяет записать двойное слово в указанный порт. 


После выполнения все эти функции возврашают переданное значение. 
Максимальное значение адресуемого порта также ограничено числом 
65 535. В листинге 1.2 представлен пример работы с функциями записи. 
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// напишем функцию для программного сброса устройства АТА/АТАРТ 
Боо] Везеебг1уе () 
{ 
// первое устройство на втором канале ( обычно СР-ВОМ) 
_очер ( 0х177, 0х08); // пишем команду сброса 081 
// проверяем результат выполнения 
Бог ( ше = 0; 1 < 5000; 1++) 
{ 
// проверяем бит 7 ВИЗУ 
1Е ( ( тр { 0%177) & 0х80) == 0х00) 
гегоагп сгице; // команда успешно завершена 
} 
гебагп Еа15е; // произошла ошибка 
} 
// напишем функцию для управления лотком СР-ВОМ 
у014 Еесе ( роо1 рОреп) 
{ 
106 1ТаеМа1е = 50000; 
// формат пакетной команды для открытия лотка 
МОВО Е)ес+ [6]= { Охлв, 0,2, 0, 0, 0 }; 
°// формат пакетной команды для закрытия лотка 
МОВР С1о5е[6]= { ОхлвВ, 0, 3, 0, 0,0 }; 
// проверяем готовность устройства 
\11е ( -- 1ТиаеМа1е > 0) 
{ 
// читаем состояние порта 
1Е ( (С4пр ( 0х177) & 0х80 == 0х00) && 
( 1пр { 0х177) & 0х08 == 0х00)) огеак; 
// закончилось время ожидания 
1Е ( 1ТоеМа1® < 1) гебагп; 
} 
о // выбираем первое устройство на втором канале 
` оцёр ( 0х176, 0хАО); 
// перед посылкой пакетной команды следует проверить состояние 
1ТноеМа1е = 50000; 
// ожидаем готовности устройства 


у11е ( -- 1ТцаеМа1е > 0) 
{ 
// читаем состояние порта 
1Е ( (Дир ( 0х177) & 0х80 == 0х%00) && 


( 1пр ( 0х177) & 0х08 == 0х00)) Бгеак; 
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// закончилось время ожидания 
1Е ( 1Т1мема1® < 1) гебаги; 
} 
// пишем в порт команду пакетной передачи АОЬ 
_оцёр { 0х177, 0хАО); 
// ожидаем готовности устройства к приему пакетной команды 
1Т1иеМа1е = 50000; 
// ожидаем готовности устройства 
ур11е ( -- 1ТмеМате > 0) 
{ 
// читаем состояние порта 
1Е ( (тр ( 0х177) & 0х80 == 0х00) && 
( пр ( 0х177) & 0х08 == 0х01)) Бкеак; 
// закончилось время ожидания 
1Е ( 1Тилема1е < 1) гебаго; 
} 
// пишем в порт пакетную команду 
1Е ( БОреп) // открыть лоток 
{ 
Еог ( ШЕГ=О; 1 < б; 1++) 
{ 
_омЕрм ( 0х170, Е}ес®[1]); // 12-байтовая команда 
} 
} 
е15е // закрыть лоток 
{ 
Рог ( ШЕЕ = 0; 1 < 6; 73++) 
{ 
_омЕру ( 0х170, С1о5е[3]); // 312-байтовая команда 
} 
} 
// проверяем результат выполнения команды, если нужно 
1Тряема1е = 50000; 
// ожидаем готовности устройства 
ре ( -- 1ТилеМа1е > 0) 
{ 
// читаем состояние порта 
1Е ( (р ( 0х177) & 0х80 == 0х00) && 
(1пр ( 0х177) & 0х01 == 0х00) 54 
( _1пр { 0х177) & 0х40 == 0х01)) ргеак; 
// закончилось время ожидания 
1Е ( 1Т1мема1е < 1) гебогп; 
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Как видите, работать с функциями ввода-вывода довольно легко и ком- 
фортно. Однако прямое их использование ‘в коде возможно лишь в У ш- 
40%5 95. Для работы с ними в профессиональных системах (например, 
\Мпа4о\$ 2000) предварительно придется писать драйвер и загружать его в 
память перед выполнением кода программы. Как это делается, я расскажу 
позднее, а сейчас поговорим о функции Ре\у1сетТоСопего1. 


1.2. Использование функции Веусе!оСопго! 


Вообще, данная функция так или иначе использует системные драйверы для 
доступа к устройствам. Эти драйверы могут входить в состав операционной 
системы или поставляться разработчиком программного продукта. Универ- 
сальность функции состоит в том, что она работает практически с любым 
драйвером, который поддерживает операции ввода-вывода. 


Функция реу1сетоСопеЕго1 имеет восемь аргументов. Первый позволяет ука- 
зать имя драйвера, через который будет осуществляться управление портами 
(в нашем случае). Второй аргумент представляет собой идентификатор кода 
требуемой операции, поскольку стандартный драйвер поддерживает не- 
сколько (от одной до сотни) операций и требуется конкретно указать, какая 
из них нужна ему в данный момент. Третий и четвертый аргументы позво- 
ляют указать буфер для передаваемых данных и его размер. Их следует при- 
менять для операции записи, иначе установить в мот. Пятый и шестой ар- 
гументы служат для получения данных от устройства (указатель на буфер 
данных и размер буфера). Если они не используются, следует установить 
оба значения в мор. Седьмой аргумент указывает на количество реально 
полученных данных. Последний аргумент является указателем на структуру 
ОУЕВТАРРЕР. Она используется при асинхронном вводе-выводе. Далее рас- 
смотрим примеры работы с данной функцией в \ш9о\5. 


В листинге 1.3 приведен пример функции, позволяющей читать данные 
с жесткого диска. Она будет работать только в \Мтдо\5 95/98/МЕ. 





Листинг 1.3. Чтение сектора диска 


#1осраде "з&ЧаЁх.В" 
#ЧеЕ1пе УМТМ32_ ртос 20$ РЕТУЕТМЕО 6 // код функции драйвера 
#ЧеЕ1пе СЕ ЕТАС 1 // флаг переноса 
// дополнительные структуры 
суредеЕ зегас® _ОТОС ВЕСТЗТЕК$ 
{ 
РМОВР геч_ЕВХ; 
РМОВР геа_ЕБХ; 
РМОВР геч_ЕсСх; 
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ОМОВР гед ВАХ; 
ОМОВР гедч_ЕОТ; 
ОМОВО гед ЕЗТ; 
ОИОВР гед_Е1ад3; 
} ОТОС _ВЕСТ$ЗТЕВ$; 
#ргаста расКк ( 1) 
суредеЕ эЕгисЕ _ПАТАВГОСК 
{ 
ОИОВР ФиЗфахгЕЗесеког; // номер начального сектора 
ИОВР Мошбесвогз; // количество секторов 
ОИОВР рВаЕЕег; // указатель на буфер данных 
} ПАТАВЬОСК; 
#ргадта раск () 
// пишем функцию чтения секторов с диска 
Боо1 Веаа$есфог ( апз1дпеа 1пЕ аОу1уе, РМОКР дибЕагеЗесбохг, 
МОВР "№ бесеогз, ТРВУТЕ 1рВоЁЁег) 


НАМОЬЕ ПОу1уег; 

ОТОС ВЕСТЗТЕВ$ гед = {0}; 

ПАТАВГОСК даа = { 

роо1 РВезу1е; 

ОМОВО @мВеза1 

// инициализируем драйвер 

Пре1уех = СкеабеЕ11е ( "\\\\.\\уи1п32", 0, 0, №, 0, 
ЕТЬЕ ЕЪАС РЕЪЕТЕ ОМ СТО$Е, 0); 

// если драйвер недоступен, выходим из функции 

1Е ( БОг1уег == ТМУАБТО НАМОГЕ УАШОЕ) гебагп Ёа1зе; 

// заполняем структуру данных ПАТАВГОСК 

Часа. ОиЗсагеЗессог = Чам5фаге$ессог; 

Часа. "Матбесеогз = уМиюзесеогз; 

Чафа.рВоЕЁег = ( ОМОВО) 1рВаЁЕЁЕег; 

// заполняем управляющую структуру 

тед.хед ЕАХ = 0х7305; // функция 73051 прерывания 218 


| 
[> 
`. 








тед.хгед ЕВХ = ( ПМОВО) &9афа; 
гед.гед_ЕСХ = -1; 
гед.гед_ЕБХ = аОг1уе; // номер логического диска 


// вызываем функцию Беу1сетТоСопего1 

ЬВези16 = Пеу1сеТоСопего1 ( ПОг1уехг, \УИ1М32_РТОС_00$_РВТУЕТМЕО, 
&гед, з12еоЕЁ ( гед), ёгед, з12ео0оЕЁ ( гед), &аиВезо1е, 0); 

// если произошла ошибка, выходим из функции 

1Е { 'ЮВезо1е || ( гед.гед_Е1адз & СЕ ЕЪАС)) 

{ 


С1озеНапа1е ( ПОг1уег); 
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гебагп Еа1зе; 

} 

гебигп 6гае; 
} 
// пример использования функции Кеа$есеог для чтения 2-х секторов диска 
// номер логического диска может быть следующим: 0 — по умолчанию, 1 -— А, 
И2-в, 3-С, 4 -ЮЬ, 4 -Еит. д. 
// выделяем память для двух секторов жесткого диска 
сВаг* раЕЁег = МОБ; 
БоЕЕег = пем сВаг[512*2]; 
// вызываем функцию чтения секторов 
ВеаЧЗесеог ( 3, 0, 2, ( БРВУТЕ) БаЕЁЕег); 
// освобождаем память 
Че1ефе [] раЕЕег; 


В профессиональных системах (МТ, ХР или 2000) использовать 
Реу1сеТоСопего1 не нужно. Там достаточно открыть функцией СкеакеЕе 
логический диск (даже СО-КОМ) и с помощью функции ВеааЕ11е прочи- 
тать данные с диска. 


Рассмотрим еще один пример для записи данных на жесткий логический 
диск (листинг 1.4). 


// пишем функцию для записи сектора диска 
Боо1 МгАфезесеког ( ипз1апеЯ 1пЕ иОг1уе, ОМОВР ам5фаг®5есфог, 
МОВО иМит$ескогз, ТГРВУТЕ 1рВаЕЁЕег) 
{ 
НАМОЬЕ ВрОт1уег; 
РТОС_ВЕСТЗТЕВ$ гед = {0}; 
ПАТАВЬОСК Чака = {0}; 
Ъоо1 ЮВеза1; 
РМОВР ЧмВези1% = 0; 
// инициализируем драйвер 
ЮОг1уег = СгеакеЕ11е ( "\\\\.\\уми132", 0, 0, №, 0, 
ЕТЬЕ ЕЪАС РЕЪЕТЕ ОМ СТОЗЕ, 0); 
// если драйвер недоступен, выходим из функции 
1Е ( БОе1хег == ТМУАБТО НАМОЬЕ УАБОЕ) гебогп Еа1зе; 
// заполняем структуру данных РАТАВЬОСК 
Чафса.ЧибъагеЗеског = ЧиЗфаге$еског; 
Чафа."Мат$ескогз = чМамбестсогз$; 
Часа.рВаЕЕег = ( ОМОВР) ]рВоЕЁЕег; 
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// заполняем управляющую структуру 

хед.гед ЕАХ = 0х7305; // функция 73051 прерывания 218 

хед.хед ЕВХ = ( ПМОВО) &Чафа; 

гед.гед ЕСХ = -1; 

хед.геч ЕПБХ = аОг1уе; // номер логического диска 

0х6001; 

// вызываем функцию Беу1сетоСоп{го1 

ЮВезо1Е = ОБеу1сеТоСопехго1 ( ИОк1уек, УМТМЗ2_ОТОС_00$ ОВТУЕТМЕО, 
&гед, з1хеоЕ ( геад), &кеа, э1хеоЕ ( гед), &мВезо1е, 0); 


| 


гед.гед Е$Т 


// если произошла ошибка, выходим из функции 
1Е ( 'ЮВези1е || ( гед.гед Е1ачз & СЕ ЕПАС)) 
{ 

С1озеНап1е ( ВОглуег); 

гебитгп Еа15$е; 
} 


тееаги Егае; 


В следующих главах книги приводятся дополнительные примеры использо- 
вания функции реу1сетоСопе ко]. 


1.3. Использование драйвера 


Данный способ является наиболее гибким и позволяет получить доступ ко 
всем устройствам в системе. Единственная сложность возникает с написа- 
нием самого драйвера. Поскольку все примеры работы с портами в книге 
основаны на применении драйверов, специально для читателей книги я на- 
писал и отладил два драйвера: виртуальный драйвер устройства УхО (УИт- 
до\5 98/МЕ) и системный драйвер 3У$ (\УИтао\м5 М№Т/2000/ХР). О том, где 
их найти, сказано во введении. Здесь же я подробно объясню, как ими 
пользоваться. Мы напишем два класса для использования этих драйверов. 
Первый класс рассчитан на работу в УИп4о\з 98/МЕ и представлен в лис- 
тингах 1.5 и 1.6. 





: Пистинг 1.5. Файл 1032.в 
// 1032.1: 1пхекЕасе Еог Бе СТОЗ2 с1азв. 
#11с1аае <м1п1ос*1.18> 
// определяем коды функций для чтения и записи 
+Чеё1пе 1032 ИВТТЕРОВТ СТЬ СОБЕ ( ЕТЬЕ РЕХТСЕ ОМКМОИМ, 1, \ 
МЕТНОР МЕТТНЕВ, ЕЕ АМУ АССЕ$5) 


+ЧеЕ1пе 1032 ВЕАОРОВТ —СТЬ СОБЕ ( Е РЕУТСЕ ОМКМОММ, 2, \ 
МЕТНОР МЕТТНЕВ, ЕТЬЕ АМУ АССЕЗ$) 
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// объявляем класс 
с1аз5 С1ТОЗ2 
{ 
раБ11с: 
СТОЗ2 (); 
—СТо}З2 (); 
// общие функции 
роо1 Ти1ЕРогЕ (); // инициализация драйвера 
// функция для считывания значения из порта 
©оо1 1пРогЕ ( МОВКО мРокге, РОМОВР рамУа1ае, ВУТЕ Ю512е); 
// функция для записи значения в порт 
роо1 очЕРогЕ ( МОВО мРогЕ, ОМОВО ФмУа1ае, ВУТЕ Ю5127е); 
рг1уасе: 
// закрытая часть класса 
НАМОГЕ БУхО; // дескриптор драйвера 
// управляющая структура 
#ргадта раск (1) 
ЗЕгасЕ садРог®3З2 
{ 
ОЗНОВТ мРоге; 
ОТОМс амуа1ае; 
ОСНАВ №5127е; 


}; 
#ргадта раск () 
}; // окончание класса 





. Листинг 1.6. Файл 1032.срр 


#10с1а4е "зЕдаЕх.В" 
#10с1оае "ТО32.в" 
// реализация класса С1ОЗ2 
// конструктор 
СТОЗ2 :: С1032 (} 
{ 
ВУхо = ОШ; 
} 
// деструктор 
СТО32 :: -СТОоЗ2 () 
{ 
1Е ( Ухо) С1озеНапа1е ( НУхЬо); 
ВУхО = №; 
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// функции 
Боо1 СТОЗ2 :: ТриЕРокЕ () 
{ 
// загружаем драйвер 
БУхр = СгеакеЕ11е ( "\\\\.\\1о32рогЕ.уха", 0, 0, МИ, 0, 
ЕГЬЕ ЕЦЧАС ОЕГЕТЕ ОМ СТОЗЕ, М); 
// если драйвер недоступен, прощаемся 
1Е ( ВУхо == ТМУАЬТО НАМОТЕ УАБОЕ) 
тебигп Еа15е; 





тебагп Егое; 
} 
Боо1 СТОЗ2 :: 1пРогЕ ( ИОВР мРогё, РОМОКО рамУа]ае, ВУТЕ 517е) 
{ 

// если драйвер недоступен, прощаемся 

1Е ( БУхо == МОШ,) гефаго Еа]15е; 

РИОВО амВебагп; 

фадРогЕЗ2 рохЕ; 


р512е; 


роге.Ь51те 
рогЕ.мРогЕ = мРогЕ; 
// читаем значение из указанного порта 
тебокп Реу1сеТоСопего1 ( НУхр, 1032_ВЕАОРОВТ, &роге, 
$12е0Е ( КадРог®З2), рамУа]ае, з12еоЕ ( ПМОВО), &амвееоги, №11); 


} 
Боо1 С1032 :: осЕРогЕ ( МОВО мРогЕ, ОМОВО амуа1ае, ВУТЕ Ю512е) 


{ 
// если драйвер недоступен, прощаемся 
1Е ( НУхО == МОШ,) гебогр Еа1зе; 
РИОВО амВебагп; 
фадРогЕЗ2 рогЕ; 


рогЕ.Ю51те = Ь3127е; 
роге.ам\а1ае = амУа1ие; 
роге.мРогЕ = мРогЕ; 


// записываем значение в указанный порт 
хебаги Оеу1сеТоСопего] ( НУхО, 1032 _ИВТТЕРОВТ, &рог®, 
$12е0Е ( КадРогЕЗ2), МОМ, 0, &@амвееигр, МО); 


Теперь у нас есть полноценный класс для работы с портами. Перед началом 
работы нужно вызвать функцию то1ЕРогЕ для загрузки виртуального драй- 
вера устройства (файл 1032роп.уха). После этого можно писать и читать лю- 
бые существующие в системе порты ввода-вывода. Каждая из функций 1п- 
РогЕ И ОсЕРОГЕ имеет по три аргумента. Первый позволяет указать номер 
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порта. Второй аргумент предназначен для передачи или получения значения 
из порта, а третий определяет размер передаваемых данных. Драйвер под- 
держивает четыре типа данных: байт (1), слово (2), трехбайтовое значение 
(3) и двойное слово (4). Не забывайте правильно указывать размер данных, . 
иначе результат будет некорректным. В листинге 1.7 показано, как следует 
работать с классом стоз2. 


// объявляем класс 

СТОЗ2 10; 

// инициализируем драйвер 

10. То1ЕРогЕ (); 

// теперь можно работать с портами 
// для примера включим системный динамик и после 4 секунд выключим 
РИОВО 9мВези1* = 0; 

// читаем состояние порта 
10.1пРоге ( 0х61, &амВезо1е, 1); 
@Вези1е |= 0х03; // включаем 

// записываем значение в порт 
10.опЕРогЕ ( 0х61, ОмВезо1+, 1); 
// пауза 4 секунды 

З1еер ( 4000); 

// читаем состояние порта 
10.1пРогЕ ( 0х61, &ЧмВези]1*, 1); 
ЯмВези1+ &= ОхЁС; // выключаем 

// записываем значение в порт 
10.ооЕРогЕ ( 0х61, амВезо1*, 1); 


Теперь подготовим второй класс стоз2мт, позволяющий работать в профес- 
сиональных системах (УЛпдо\з №Т/2000/ХР/$ВЗ). В листингах 1.8 и 1.9 
представлены файлы определений и реализации класса. 





‚ Листинг 1.8. Файл 1ОЗ2МТ.Н 

#1осТтаае <\м1п1осе1.6> 

// определяем коды функций драйвера 

#ЧеЁ1пе ЕТЬЕ РЕУТСЕ ИТМТО 0х00008010 

#+ЧеЁ1пе ИТМТО ТОСТЬ ТМОЕХ 0х810 

#ЧеЕ1пе ТОСТЬ ИТМТО ЕМАВГЕОТВЕСТТО —СТЬ СОРЕ ( ЕТЬЕ РЕХШСЕ ИТКТО, \ 
ИТМТО ТОСТЬ ТМОЕХ + 2, МЕТНОР ВОЕЕЕВЕО, ЕТЬЕ АМУ АССЕЗ5) 

#АеЁ1пе ТОСТЫ ИТМТО РТЗАВГЕРТВЕСТО СТЬ СОБЕ ( ЕТШЕ РЕУТСЕ ИТМТО, \ 
ИТМТО ТОСТЬ ТМОЕХ + 3, МЕТНОР_ВОЕЕЕВЕО, ЕТЬЕ АМУ АССЕЗ$5) 
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'/ объявляем класс 
21аз$ СТОЗ2МТ 
{ 
рер11с: 
СТОЗ2МТ (); 
=СТоЗ2мтТ (}; 
// общие функции 
роо1 То1ЕРОгЕ (); // инициализация драйвера 
// функция для считывания значения из порта 
уо1А апРогЕ ( МОВР мРоге, РОМОВО рам\Уа1Тае, ВУТЕ Ю517е); 
// функция для записи значения в порт 
%У01А опЕРОогЕ ( МОВР мРогё, РИОВО амУуа1ае, ВУТЕ Ю5$17е); 
рх1уафе: 
// закрытая часть класса 
НАМОТЕ №55; // дескриптор драйвера 
// служебные функции 
// загрузка сервиса 
Роо1 1оаЯЗегу1се ( РЗТВ рэз20г1уег); 
роо1 _добегу1се (); // запуск сервиса 
Ьоо} _эрорбегу1се (); // остановка сервиса 
роо} _Егеебегу1се (); // закрытие сервиса 
}; // окончание класса 
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‚ Листинг 1.9. Файл 1032МТ.срр 





з1пс1оаае "зЕЧаЁх.В" 
нос]1аае "ТОЗ2МТ.В" 
+:пс1оаае «сопло. В> 
1ос1аде <Изпзус.В> 
// реализация класса СТОЗ2МТ 
// конструктор 
с1032мТ :: СЗ2МТ () 

8$у5 = М0; 
} 
// деструктор 
Сг032МТ :: -СтоЗамт () 

ОМОВР амВефагп; 

1Е ( 53У$ != ТМУАБТО НАМОЬЕ УАБОЕ) 

{ 

// блокируем драйвер 

Ре\1сеТоСопеко1 ( 15У$, ТОСТЬ ИТМТО ОТЗАВЬЕПОТВЕСТТО, МО, 

0, МОТ, 0, &Чмвееако, МОЦЬ); 
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С1озеНапа1е ( 15У5); // закрываем драйвер 
} 
// освобождаем системные ресурсы 
_Етеебегу1се (); 
15У5 = МО; 
} 
// функции 
Боо1 СТОЗ2МТ :: Тю1ЕРогЕ () 
{ 
Боо1 ЮВезо1*; 
РОТВ рз2Тепр; 
спаг з72Ехе[МАХ_РАТН]; 
РИОКО омВее; 
// открываем драйвер 
В5У5 = СгеабеЕ11е ( "\\\\.\\ТОсгвекм", СЕМЕВТС ВЕАО | СЕМЕВТС ИВТТЕ, 
0, МОШ., ОРЕМ ЕХТЗТТМС, ЕТЬЕ АТТАТВОТЕ МОВМАЪ, МОБ); 
// если не удалось, инициализируем службу сервисов 
1Е ( 15$ == ТМУАЬТО НАМОЬЕ УАТГОЕ) 
{ 
// получаем имя программы 
1Е ( !СеЕМодо1еЕ11еМаще ( СеЕМодо1еНапа1е ( МОТ), э2Ехе, 
312е0Е ( э2Ехе))) 
тебагп Еа1зе; 
// ищем указатель на последнюю косую черту 
рз2Тешр = зЕггсИг ( з2Ехе, '\\')}; 
// убираем имя программы 
рэхТетр[1] = 0; 
// а вместо него добавляем имя драйвера 
5Егсабс ( зтЕхе, "ТОЕг5зегу.зуз"); 
// загружаем сервис 
ЮВези1Е = 1оабегу1се ( з2Ехе); 
// если ошибка, выходим из функции 
1Е ( !6Везо16) гебагп Еа15е; 
// запускаем наш сервис 
ЮВези1& = добегу1се ({); 
// если ошибка, выходим из функции 
1Е ( !ЮВезо]{) гебагр Еа15е; 
// открываем драйвер 
855 = СгеакеЕ11е ( "\\\\.\\ТОЕг5егу", СЕМЕВТС ВЕАР | 
СЕМЕВТС ИВТТЕ, 0, МОЬБЬ, ОРЕМ_ЕХТЗТТМС, ЕТЪЕ АТТВТВОТЕ МОВМА!,, МОГ,); 
// если не удалось, выходим из функции 
1Е ( 85У8 == ТМУАБТО НАМОЬЕ УАГОЕ) геботп Еа15е; 
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} 


1Е ( !Беу1сеТоСопего1 ( №$У5, ТОСТЬ ИТМТО ЕМАВТЕОТВЕСТТО, МОШ,, 


0, МОГ, 0, &амвее, мо) } 
тебагп ЁЕа15е; // драйвер недоступен 
тебого Егуе; 


Боо1 СТОЗ2МТ :: _1оаа5егу1се ( РЗТВ р$2Ог1уег} 


{ 


} 


$С НАМОТЕ п5ху; 

3С НАМОТЕ РМап; 

// на всякий случай выгружаем открытый сервис 
_Етеебегу1се (); 


// открываем менеджер сервисов 

ВМап = Ореп5СМападег ( МОШЬ, МОШ., 5С_МАМАСЕВ_АП, АССЕ$5); 
// создаем объект сервиса из нашего драйвера 

1Е ( БМап) 


{ 


НЗку = Сгеакезегу1се ( ЬМап, "ТОкгзегу", "ТОЕгзегу", 


ЗЕВУТСЕ АТГ АССЕ$5, ЗЕВУТСЕ КЕВМЕГ ОВТУЕВ, ЗЕВУТСЕ_РЕМАМР _ЗТАВТ, 
ЗЕВУТСЕ_ЕВВОК_МОВМАТ, рз20г1уег, МОШ., МОГ, МОБ, МО, МОБ); 


// освобождаем менеджер объектов 
С1озебегу1сеНапа1е ( ЮМап); 
1Е ( №5гу == МОБЬ) гебагп Еа15е; 


} 


е1зе ‘ 


тебогп Еа]15е; 
С1озебеху1сеНапа1е ( ПМап); 
тебагп Егие; 


Бо01 СТОЗ2МТ :: _добеку1се () 


{ 


Боо1 Без; 

3С НАМОГЕ И$ху; 

$С НАМОГЕ Май; 

// открываем менеджер сервисов 

ПМап = Ореп5СМападег ( МОБ, МОШ., $С МАМАСЕВ_АТТГ АССЕЗ$); 
1Е ( БМап) 


{ 


// открываем сервис 

В5гу = Орепбегу1се ( ЮМап, "ТОегзегу", ЗЕВУТСЕ АБЫ АССЕЗ5); 
// закрываем менеджер сервисов 

С1озебегу1сеНапа1е ( РМап); 

1Е ( Ь3хУ) 

{ 
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// запускаем сервис 
ЮВез = ЗеагЕбегуасе ( №5гу, 0, МОБ); 
// в случае ошибки закрываем дескриптор 
1Е( !5Вез) 
СЗозебегу1сеНапа1е ( №5гу); 
} 
е1зе 
гегигп Еа15е; 
} 
е15е 
гегаго Еа15е; 
тебагп ЮВез; 
} 
Боо1 СТОЗ2МТ :: _зЕорбеку?се () 
{ 
роо1 Без; 
ЗЕВУТСЕ 5ТАТУ$ эзкубеаеаз; 
$С_НАМОЪЕ РМап; 
$С_НАМОБЕ ИЗ; 
// открываем менеджер сервисов 
ЮМап = Ореп5СМападекг ( МО, МОТЬ, 5С_МАМАСЕВ АШ, АССЕ$5); 
1Е ( РМап) 
{ 
// открываем сервис 
В5гу = Орепбегу1се ( ЮМап, "ТОЕгзегу", ЗЕВУТСЕ АШ, АССЕЗ5); 
// закрываем менеджер сервисов 
С1озебегу1сеНапа1е ( ПМап); 
1Е ( В95ку) 
{ 
// останавливаем сервис 
ЮВез = Сопфго15егу1се ( р5гу, ЗЕВУТСЕ СОМТВОГ $ЗТОР, &згубфаеиз); 
// закрываем сервис 
С} озебегу1сеНап1е ( п5ку); 
} 
е}5е 
геогр Еа15е; 
} 
е1зе 
гесагр Еа15е; 
гееагп ЮВез; 
} 
Роо1 СТОЗ2МТ :: _Егеебеку1се () 
{ 
роот ЮВез; 
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3С НАМОГЕ В5ху; 
3С_НАМОГЕ ВМап; 
_// останавливаем наш сервис 
_з6орбегу1се (); 
// открываем менеджер сервисов 
ЬМал = Ореп5СМападехг ( МО, МОШ., $С МАМАСЕВ АБЬ АССЕЗ5); 
1Е ( ЬМап}) 
{ 
// открываем сервис 
В5ку = Орепбегу1се ( РЮМап, "ТОЕгзегу", ЗЕВУТСЕ_АБ. АССЕЗЗ); 
// закрываем менеджер сервисов 
С1озеЗегу1сеНапЯ1е ( ВМап); 
1Е ( В$ку) 
{ 
// удаляем наш сервис из системы и освобождаем ресурсы 
ЮВез = Ое1ебебегу1се ( №5гу); 
// закрываем дескриптор нашего сервиса 
С1озебегу1сеНапа1е ( в5ху); 
} 
е15е 
гебагп Еа1зе; 
} 
е1зе 
гегогп Еа15е; 
гебагп ЮВез; 
} 
// пишем функции ввода-вывода 
\о1А СТОЗ2МТ :: 1пРоге ( МОВО мРоге, РОМОВР рамуа]ие, ВУТЕ Ь512е) 
{ 
змТЕСВ ( Ю$512е} 
{ 


сазе 1: 


*рамуа1иае 
ргеаК; 
сазе 2: 


_1пр( мРоге); 


*рам/а]е = _1прм ( мРогЕ); 
ргеаК; 

сазе 4: 
*рамУа]1ае = _1пра ( мРотгё); 
ргеаК; 
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уо1а СТОЗ2МТ :: осЕРогЕ ( МОВО мРогЕ, РИОВО @мУа1ае, ВУТЕ Ю$12е) 
{ 
Зи1ЕСВ ( 65127е) 
{ 
сазе 1: 
_©мЕр ( мРоге, ( ВУТЕ) амУа1ае); 
ргеак; 
сазе 2; 
_омЕри ( мРоге, ( МОВО) амУа1ае); 
ргеак; 
сазе 4: 
_счЕра ( мРоге, амУа1ае); 
ргеак; 


Второй класс получился более громоздким за счет особых требований к ра- 
боте драйверов в профессиональных системах. Пришлось использовать 
функции менеджера служб ЗСМ (Зегусе СопНо| Мапавег) для регистрации 
нашего драйвера в качестве сервиса. Только в этом случае система позволя- 
ет получить доступ к аппаратуре. Пример работы с классом стоз2мт приво- 
дить не буду, поскольку он ничем не отличается от предыдущего класса. 


1.4. Использование ассемблера 


Четвертый вариант работы с портами заключается в применении встроенно- 
го в У!5иа! С+- ассемблера. Как известно, ассемблер содержит две команды 
для доступа к портам ввода-вывода: 10 И ос. Однако далеко не в каждой 
операционной системе удастся воспользоваться этим способом (командами 
ввода-вывода), поэтому данный вариант рекомендую использовать только в 
УЛпао\мз 95/98/МЕ. Для наглядности рассмотрим пример работы со встро- 
енным ассемблером кода, показанного в листинге 1.10. 





: Листинг 1.10. Использование встроенного ассемблера в Мзиа! С++ 
// простой пример функции для управления системным динамиком 
у01А РС Ч1паюак ( Боо1 БОп) 
{ 
змтЕесв ( РОп) 
{ 


сазе Егае: 
азм 
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зо а1, 616 
ог а1, 000000115 // включить динамик 
очЕ 618, а1 

} 

ргеак; 

сазе Еа15е: 

__ аз 

{ 
10 а1, 618 
апЯ а1, 111111006 // отключить динамик 
ое 610, а+ 

} 

ргеак; 


Встроенный макроассемблер практически ничем не отличается от полно- 
ценного ассемблера. Имеются некоторые ограничения, но, в общем, его с 
успехом можно применить в собственной программе. Сразу хочу заметить, 
что вызывать прерывания (для упрошения работы) не следует. Это в лучшем 
случае приведет к фатальной ошибке в программе, а в худшем — "завесит" 
всю систему. 


Вот мы и рассмотрели несколько документированных способов работы с 
оборудованием в операционных системах УЛпао\5. А теперь поговорим 
о том, есть ли какая-нибудь альтернатива, которая позволяла бы програм- 
мировать порты ввода-вывода без драйверов и различных ограничений. 


1.5. Недокументированный доступ к портам 


В многозадачной системе У/тдо\з для гарантированно устойчивой (относи- 
тельно, конечно) работы пришлось использовать так называемый защищен- 
ный режим, в котором эффективно разделяются различные выполняемые 
задачи вместе с используемыми данными. Для выполнения этой задачи по- 
требовалось гораздо больше места под описание адресов, указываемых через 
сегментные регистры процессора, чем они физически могли предоставить. 
Было решено в сегментные регистры вместо реальных адресов загружать так 
называемые селекторы. Селектор представляет собой указатель на 8-байт- 
ный блок памяти, который содержит всю необходимую информацию о сег- 
менте. Все эти блоки собраны в таблицы глобальных (СОТ — Соба! Ое- 
$спрюг ТаЫе) и локальных (ГОТ — оса! Безсирюг Тае) дескрипторов. 
Кроме того, существует и таблица дескрипторов прерываний (ШТ — Ицег- 
гирё Оезсирюг Та Бе). Селектор состоит из номера дескриптора (адреса) 
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в таблице (биты 3—15), типа таблицы (1 — ВОТ, 0 — СОТ) (бит 2) и уровня 
привилегий в битах 0—1 (биты 0—3). Уровень привилегий определяет статус 
выполняемой задачи. Самая высокая степень привилегий (005) позволяет 
программе работать на уровне ядра. Второй уровень (01ъ) дает полный дос- 
туп к аппаратуре. Третий (105) и четвертый (115) уровни управляют различ- 
ными прикладными программами и расширениями. Не буду вдаваться в 
тонкости, но для доступа к портам ввода-вывода нам нужно попасть на са- 
мый высокий уровень (нулевой), для чего необходимо методом перебора 
получить свободный дескриптор. 


Далее мы разберем использование наивысшего уровня привилегий только 
для операционных систем \Утао\5 95/98/МЕ. Говорят, есть аналогичный 
вариант и для профессиональных систем, но мне он неизвестен. Итак, на- 
пишем еще один класс для прямого доступа к портам ввода-вывода. В лис- 
тингах 1.11 и 1.12 представлены соответствующие файлы класса т1032_0, ко- 
торый позволит нам без проблем работать напрямую с любым оборудовани- 
ем в операционных системах \Мвао\з 95/98/МЕ. 





: Листинг 1.11. Файл Ю32_0.Н 
// объявляем класс 
с1азз 1032_0 
{ 
раб: с: 
1032_0 (); // конструктор 
10320 () { } // пустой деструктор 
// общие функции 
// прочитать значение из порта 
Ьоо1 1пРогЕ ( МОВО мРохе, РОМОВР рамУа1ае, ВУТЕ 6517е); 
// записать значение в порт 
Боо1 опЕРогЕ( МОВО мРоге, ПОМОВО амУа1ле, ВУТЕ Ь$17е); 
рг1уасе: 
#огадта раск (1) 
// объявляем структуры 
// структура для поиска дескринтора в таблице 
туреаеЕ зегасе _СОТ 
{ 
МОВР 16; // лимит 
ОМЮВО Вазе; // база 
} СОТ; 
// описание дескриитора для сегмента данных 
фуреЯеЕ зегисё _СОТ_НАМОГЕ 
{ 
МОВО Ъ 0 15; // биты 0-15 лимита 
МОВО В_0_15; // биты 0-15 базы сегмента 
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ВУТЕ В_16 23; // биты 16-23 базы сегмента 

ВУТЕ Ассезз : 4; // доступ к сегменту 

ВУТЕ Туре : 1; // тип сегмента (1 - код, 0 -— данные) 

ВУТЕ ОРЬ : 2; // уровень привилегий для дескриптора сегмента 

ВУТЕ ТзВеаЯ : 1; // проверка наличия сегмента 

ВУТЕ 1 16 19 : 4; // биты 16-19 лимита 

ВУТЕ О$ : 1; // определяется операционной системой 

ВУТЕ В5У МОГ : 1; // резерв 

ВУТЕ В 321316 : 1; // разрядность ( 1 — 32-разрядный сегмент, 0 -— 15} 

ВУТЕ Г, Сгапа? : 1; // гранулярность (1 - 4 Кб, 0 — в байтах) 

ВУТЕ В 24 31; // биты 24-31 базы сегмента 
} СОТ_НАМОТЕ; 
// описание дескриптора шлюза 





{уредеЁ зёгасЕ _51а3се Напа1е 
{ 
МОВО ТазК ОЕЁЕзеф_0_ 15; // младшее слово смещения для шлюза задачи 
МОВО Зедтепе_ $; // селектор сегмента 
МОВО БИОВР Сочи : 5; // число двойных слов для работы стека 
ОВО МОЪЬ 5 7 : 3; // равно 0 
МОВО Ассезз : 4; // доступ к сегменту 
ИОВО Туре : 1; // тип шлюза 
ИОВО ОРЁ : 2; // уровень привилегий для дескриптора шлюза 





ИОВЬ Т5Веаа : 1; // проверка наличия сегмента 
МОВР Тазк ОЕЁзе 16_31; // старшее слово смещения для шлюза задачи 
} $1а1се Напа1е; 
}ргадша раск () 
// функция доступа к портам 
роо] Са1]Ассез$ ( РУОТО ЕКоапсЕ1опАЯяЯгез5, ИОВО иРоге, РОМОВО рамУа1ще, 
ВУТЕ 517е); 
}; // окончание класса 


: Листинг 1.12. Файл 1032_0.срр 





Нпсраае "зЕдаЕх.В" 
Я пс]аае "То32_0.6" 
// реализация класса 
1032_0 :: 1032_0 () 
{ 
// пустой конструктор 
} 
// две функции для обработки портов ввода-вывода 
_ @ес]5рес ( пакеЧ) уо1а озЕРогЕ\а1ае ()} 
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_ аз 
{ 
сир с1, 1 // если размер данных равен байту 
)е Вуе // записываем байт 
стр с1, 2 // если размер данных равен слову 
3е ога // записываем слово 
спр с1, 4 // если размер данных равен двойному слову 
3е _Пмока // записываем двойное слово 
_Вуее: 
пох а1, [еъх] 
омЕ @х, а1 // записываем байт в порт 
гееЕ // выходим 
_Мога: 
моу ах, [еЪх] 
опЕ ах, ах // записываем слово в порт 
гееЕ // выходим 


_Обмога: 
шоу еах, [еЪх] 
опЕ 4х, еах // записываем двойное слово в порт 
хеЕЕ // выходим 


__Чес15рес ( пакеЯ) ухоза _1пРог®\Уа1ое () 


_ аэм 
{ 
сир с1, 1 // если размер данных равен байту 
)е _Вубе // читаем байт 
сшр с1, 2 // если размер данных равен слову 
Зе _Мога // читаем слово 
сир с1, 4 // если размер данных равен двойному слову 
)е _ОБмога // читаем двойное слово 
_Вубе: 
1п а1, ах // читаем байт из порта 
шоу [ебх], ат 
гебЕ 
_Мога: 
1п ах, ах // читаем слово из порта 
шоу [ерх], ах 
гесЕ 
_Омога: 
11 еах, ах // читаем двойное слово из порта 
шоу [ерх], еах 
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гесЕ 


} 

// функция поиска свободного дескриптора в системе 

6001 10320 :: Са11Ассезз ( РУОТР Еапс1опАЯагезз, МОВО чРоге, 
РОМОВО рамУа?ае, ВУТЕ Ь5127е) 


МОВО ла = 1; // счетчик циклов 
МОВО АаЯх[3]; // адрес для нашей задачи 
СОТ аа®; 
СОТ НАМОБЕ *рнНАМОГЕ; 
// получаем регистр СОТВ, начиная с 286 процессора 
_аэа заае [946] 
// переходим ко второму дескриптору сегмента данных 
РНАМОГЕ = ( СОТ НАМОЬЕ*) ( д9%.Вазе + 8); 
// выполняем поиск свободного дескриптора в таблице СОТ 
Бог ( Миа = 1; „№ < ( аае.1116 / 8); момч+) 
{ 
// если указанные поля структуры равны 0, 
// свободный дескриптор найден 
1Е ( РНАМОГЕ->ТзВеаа == 0 && РНАМОГЕ->ОРЬ == 0 58 
РНАМОГЕ->Туре == 0 && РНАМОТЕ->Ассезз == 0) 





// определяем параметры для дескриптора шлюза 
$101се Нап@е *р51о1се; 
р511се = ( 511се Напа1е»*) РНАМОРЬЕ; 
// младшее слово адреса нашей функции 
р5№а1се->ТазК ОЕЁзек 0 15 = ТОМОВО ( Рарс®1опАаагез$з); 
// селектор сегмента с наивысшим уровнем привилегий 
р5111се->бедтепе_ $ = 0х28; 
р51о1се->0МОоВр Сочи = 0; 
р5о1се->мрь 57 = 0; 
р5]а1се->Ассезз$ = 0х0С; 
р51азсе->Туре = 0; 
р51а1се->0РЬ = 3; 
р511се->15Веаа = 1; 
// старшее слово адреса нашей функции 
р$101се->ТазК ОЕЁзе 16 31 = НТМЮВО ( Гопсе1опАдагезз); 
// заполняем адрес для дальнего вызова 
АЗаг [0] = 0х00; 
Ааах [1] = 0х00; 
Аааг[2] = ( м№м << 3) | 3; 
// передаем наши параметры 
азт 
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шоу ебх, [рамУа1ае] // передаваемое значение 
шоу с1, [Ь517е] // размер передаваемого значения 
по\у Ах, [\Рог®] // номер порта ввода-вывода 
// выполняем дальний вызов 
са11 Емога рег [Ада] 
} 
// обнуляем дескриптор 
метзее ( рНАМОЬЕ, 0, 8); 
тебагп &гие; // выходим из функции 
} 
// проверяем следующий дескриптор 
РНАМОЬЕ++; 
} 
// не найдено ни одного свободного дескринтора 
гебоги Еа]5е; 
} 
// общедоступные функции ввода-вывода 
Боо1 1032 0 :: очЕРоге ( МОВО мРоге, ОМОВО амУа1фае, ВУТЕ 6$12е) 
{ 
тесагп Са11Ассезз ( ({ РУОТО) очеРогЕУа]ае, мРоге, &ЧмУа1ще, Ь$512е); 
} 
Ьоо1 10320 :: 1пРогЕ ( МОВР “Роге, РОМОВР рамУа1ае, ВУТЕ Ю$127е} 
( 
тесогл Са11Ассезз ( { РУОТО) 1пРогЕУа]ое, мРоге, рачуа]ме, р517е); 


Вот у нас и получился полноценный класс для работы с аппаратными пор- 
тами. Используется он таким же образом, как и предыдущие классы. Прин- 
цип работы класса 1032_0 построен по следующему алгоритму: вначале вы- 
полняем поиск свободного дескриптора в таблице СОТ. Для получения на- 
чального указателя на таблицу применяем системную команду заае. После 
этого производим поиск свободного (не используемого системой) дескрип- 
тора. Если дескриптор найден, присваиваем ему указатель на заполненный 
дескриптор шлюза (511се_напа1е). Через структуру шлюза определяем адрес 
функции, на которую будет передано управление посредством дальнего вы- 
зова, а также общие параметры доступа и уровень нривилегий. Далее запи- 
сываем аргументы для функции и непосредственно выполняем дальний вы- 
зов, который будет обработан процессором с максимальным приоритетом. 
Таким образом, мы получим доступ к аппаратным портам, и операционная 
система не будет мешать этому. 


Вот и все, что мне хотелось рассказать о методах работы с портами ввода- 
вывода в \/т4о\5. Вы можете использовать наиболее удобный для вас вари- 
ант, чтобы без проблем работать с примерами из последующих глав книги. 


ГЛАВА 2 


Мышь 


Было время, когда мышь была скорее экзотикой, чём необходимым компо- 
нентом компьютера. В самом деле, используемые операционные системы не 
имели графического интерфейса, и все общение с ними было построено 
исключительно на работе с клавиатурой. Но, как всегда, извечная человече- 
ская лень и стремление приблизить компьютер к реальной жизни подтолк- 
нули разработчиков к созданию графического представления компьютерных 
данных, отображаемых на дисплее. Операционные системы стали приобре- 
тать красивый и удобный интерфейс, в котором вся основная информация 
предоставлялась пользователю в графическом виде, к слову, более привыч- 
ном и понятном человеческому глазу. Вот тут-то и появилась необходи- 
мость в простых устройствах, позволяющих легко управлять современными 
компьютерными программами. Одним из таких устройств и явилась мышь. 
Прошло немного времени, и она завоевала безоговорочную популярность 
среди обычных пользователей. Естественно, это не могло не отразиться на 
разработчиках программного обеспечения: им пришлось добавлять в свои 
программы поддержку мыши. Вот о том, как реализуется работа с мышью 
в современных операционных системах \/тдо\5, я и хотел бы рассказать в 
данной главе. 


Вниманию читателей будет предложено три способа программирования со- 
временного устройства мыши: 


1. С использованием функций В1О5 для прерывания 16 155. 
2. С использованием аппаратных портов. 
3. С использованием возможностей стандартного интерфейса \М 32 АР]. 


Каждый из представленных выше способов имеет свои достоинства н нс- 
достатки, поэтому выбор оптимального варианта должен отвечать в первую 
очередь требованиям программиста по использованию мыши в своей про- 
грамме. Как правило, возможностей \У!п132 АР1 вполне достаточно. Если же 
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вы пишете драйвер для мыши или хотите использовать расширенные воз- 
можности, недоступные в \\!132 АР1, выбор очевиден — доступ через функ- 
ции В!О$ или аппаратные порты. Использование портов вообще является 
универсальным и самым мощным способом доступа к мыши (или к любому 
другому устройству), но для этого необходимо хорошо знать устройство 
мыши и иметь полную документацию на выбранный стандарт (например, 
Р$/2 или 05В). Если по устройству различных мышей информации доста- 
точно, То найти в свободном доступе полную спецификацию для полноцен- 
ного программирования очень не просто. Такая информация, как правило, 
предоставляется разработчиками стандартов за деньги. 


На сегодняшний день существует несколько основных стандартов для ин- 
терфейса мыши: последовательный (5епа| Моцзе), РЗ/2 и 9$В (Опимегза 
5епа| Виз). Последовательный интерфейс (К$-232С) является одним из са- 
мых старых и постепенно вытесняется современными интерфейсами Р5/2 и 
05В. В современном компьютере уже не удастся найти мышь, подключен- 
ную к последовательному порту (СОМ), поскольку ее полностью заменила 
мышь стандарта Р5/2. Использование универсальной последовательной ши- 
ны О5В для подключения мыши является скорее данью моде, а не практи- 
ческой целесообразностью. Этот стандарт не дает важных преимуществ пе- 
ред Р$/2, а только занимает ОЗВ-порт. Существует огромное количество 
других, более важных устройств (принтер, сканер, веб-камера), которые 
можно подключать к ОЗВ-порту. Для мыши специально выделен собствен- 
ный порт Р$/2 и следует использовать именно его. 


2.1. Общие сведения 


Как уже было отмечено выше, стандарт Р$/2 использует последовательный 
протокол передачи данных. Если посмотреть на заднюю стенку компьютера, 
то можно увидеть небольшой круглый разъем, имеющий шесть контактных 
отверстий. Точнее говоря, их там два: для мыши и для клавиатуры, т. к. по- 
следняя использует тот же стандарт и протокол для передачи данных. Кла- 
виатура будет рассматриваться в следующей главе, а здесь только замечу, 
что оба устройства подключаются к контроллеру клавиатуры. Физическая 
структура Р$/2 представлена в табл. 2.1. 


Таблица 2.1. Структура разъема Р$/2 








Номер контакта Описание 
1 ОАТА (линия данных) 
2 Не используется 


з СМО О \ (земля) 
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Таблица 2.1 (окончание) 


Номер контакта Описание 
+5 М (питание) 
СЕК (синхронизация по времени) 


Не используется 


Принцип работы Р$/2 мыши достаточно прост: данные со встроенного в 
мышь микропроцессора поступают на контроллер клавиатуры, находящийся 
на материнской плате (например, интегрированный контроллер ше 8042 
или У 8242). На этом этапе происходит также синхронизация последова- 
тельно передаваемых данных. Контроллер клавиатуры преобразует посту- 
пающую информацию и (посредством ВОЗ) передает эти данные драйверу 
мыши. Двунаправленный последовательный обмен данных между мышью и 
компьютером (контроллером клавиатуры) происходит через линию данных, 
в зависимости от сигнала синхронизации. Например, установка компьюте- 
ром нулевого значения на линии синхронизации позволяет запретить пере- 
дачу данных. Устройство постоянно генерирует сигнал синхронизации. 
Прежде чем передать данные, компьютер устанавливает линию синхрониза- 
ции в 0. Далее следует передача данных, линия данных устанавливается в 0, 
алиния синхронизации — в 1. Данные передаются в следующем порядке: 


1. Стартовый бит (всегда должен быть равен 0). 
2. Восемь бит данных, начиная с младшего. 

3. Один бит четности. 

4. Стоповый бит (всегда равен 1). 


Любая мышь Р$/2 имеет как минимум два счетчика, отслеживающих дви- 
жение: по оси Х и по оси У. Значение каждого счетчика определяется 
9-разрядным двоичным числом (старший разряд является знаковым) и свя- 
занным с ним флагом переполнения. Каждое значение счетчика и состоя- 
ние кнопок мыши передаются на компьютер в виде пакета данных. Размер 
одного такого пакета данных равен 3 байтам. Формат пакета данных, пере- 
даваемых двухкнопочной мышью Р5/2, представлен в табл. 2.2. Для мышей 
с тремя и более кнопок формат пакета данных будет расширен до 4 байтов. 


Таблица 2.2. Формат пакета данных мыши Р$/2 


Бит 
Байт 7 6 5 4 3 2 1 0 
1 У\ ХМ \5 Х$ 1 0 (М) В [В 
Х7 х6 Х5 Х4 ХЗ Х2 Х1 Хо 


\7 \6 \5 \4 УЗ \2 \1 \0 
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Сокращения в табл. 2.2 имеют следующие значения: 


С Е — состояние левой кнопки мыши (имеет значение |, если кнопка на- 
жата); 


С КВ — состояние правой кнопки мыши (имеет значение 1, если кнопка 
нажата); 


С Х$ и \У5 — знаковый разряд перемещения по осям (имеет значение 1, 
если установлен знак минус); 


С ХУ и УУ — состояние переполнения при перемещении по осям (имеет 
значение 1, если произошло переполнение); 


СО Х0—Х7 — движение по оси Х; 
С %0—У7 — движение по оси У: 


О М — состояние средней кнопки мыши. Для двухкнопочной мыщи это 
значение равно 0. 


После посылки очередного пакета счетчики движения сбрасываются в 0, а 
диапазон возможных значений лежит в промежутке между —255 и 255. Если 
диапазон превышен, устанавливается бит переполнения и дальнейшая ра- 
бота счетчиков движения возможна только после сброса. Сброс счетчиков 
происхолит также при получении устройством мыши любой команды от 
компьютера, кроме везепа (0хЕЕ). Описание команд приводится далее в 
разд. 2.3. 


Мышь Р5/2 имеет два важных свойства, определяющих ее работу: частоту 
дискретизации и чувствительность. Частотой дискретизации называется 
число выборок в секунду, передаваемых устройством мыши на компьютер. 
Поддерживаются следующие значения частоты: 200, 100, 80, 60, 40, 20 и 
10 выборок за одну секунду. По умолчанию используется 100 выборок в се- 
кунду. Изменить это значение можно с помошью команды 5еЕ Запр1е Васе 
(ОхЕЗ). 





Под чувствительностью понимается количество отсчетов, фиксируемых 
счетчиками движения на расстоянии одного миллиметра. Стандартом ого- 
ворены несколько уровней чувствительности: 1, 2, 4 и 8 отсчетов. По умол- 
чанию используются 4 отсчета на один миллиметр. Кроме того, на чувстви- 
тельность может влиять так называемый режим масштабирования. По умол- 
чанию он равен 1:1, не влияя на чувствительность мыши. Можно также 
установить дополнительный масштаб |:2, который существенно увеличива- 
ет чувствительность устройства. В табл. 2.3 представлены значения счетчика 
в режиме масштабирования 1:2. Принцип работы масштабирования устро- 
ен на дополнительном алгоритме пересчета, применяемом к счетчикам 
движения, перед началом передачи данных на компьютер. 
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Таблица 2.3. Значения счетчика перемещения в режиме 1:2 


Значение счетчика движения Пересчитанное значение 
0 0 
1 1 
2 1 
З З 
4 6 
5 9 
М> 5 2х м 


Мышь Р5/2 поддерживает четыре стандартных режима работы. 


1. 


Режим сброса может быть установлен после подачи питания или с по- 
мошью команды Везее (охЕЕ). 


Потоковый режим залан по умолчанию и является основным режимом 
работы мыши Р$/2. В нем осуществляется передача данных между уст- 
ройством мыщи и компьютером. Если мышь находится в дистанционном 
режиме, можно применить команду зе Ветофе Моде (0хЕ0) для перевода 
ее в потоковый режим. 


, 


. Дистанционный режим позволяет управлять передачей данных от мыши 


на компьютер только по запросу последнего. Компьютер может запро- 
сить тип устройства (сер Беу1се 10), состояние (з+аъаз Весаезе), а также 
данные (веаа Рака). Для ввода мыши в данный режим используется 
команда зеЕ Ветобе Моде (0хЕ0). 


Эхо-режим позволяет любой посланный компьютером байт вернуть об- 
ратно. Может применяться для тестирования устройства мыши. Вклю- 
чить данный режим можно с помошью команды 5$еф Угар Мое (0хЕЕ). 
Для выхода из режима следует применить команду Везеф Игар Моде (9хЕС) 
ИЛИ Везеф (0хЕЕ). 


После входа в режим сброса устройство мыши выполняет самодиагностику 
и устанавливает следующие параметры: частота дискретизации равна 
100 выборок в секунду, чувствительность — 4 отсчета на один миллиметр, 
масштабирование — 1:1, передача данных отключена. В случае успешного 
самотестирования мышь посылает компьютеру значение охдд, а в случае 
ошибки — значение охЕс. Кроме того, после кода тестирования (0хАА или 
0хЕС) мышь посылает идентификатор устройства, всегда равный 0х00. В лю- 
бом случае при получении данных от мыши общий контроллер клавиатуры 
вырабатывает стандартное прерывание тв012, которое закреплено за мышью 
и является постоянным для большинства компьютеров. 
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Вот и все общие сведения о мыши стандарта Р5/2, с которыми мне хотелось 
познакомить читателя. Детальное описание команд приводится в разд. 2.3. 
Теперь же перейдем к программированию любого типа мыши, используя 
возможности базовой системы ввода-вывода (ВТО5). 


2.2. Использование функций ВО$ 


Для поддержки работы с мышью используется прерывание В1О$ {пе 15%. 
Набор значений, поддерживающий мышь Р5$/2, лежит в диапазоне от с200% 
до С209ъ. Старший байт определяет номер функции с2., а младший — но- 
мер подфункции. В табл. 2.4 представлен список всех подфункний, управ- 
ляющих работой мыши Р5$/2. 


Таблица 2.4. Подфункции ВЮ$ для Р$/2 


Значение 
подфункции Описание 
о0в Включение или выключение устройства мыши 
018 Сброс устройства мыши 
028 Установка частоты дискретизации 
оЗь Установка чувствительности 
04В Получение идентификатора устройства мыши 
058 Инициализация устройства мыши 
6, Установка режима масштабирования и получение информации 
о состоянии 
О7Ь Указание нового адреса обработчика для устройства мыши 
о8ь Запись данных в порт устройства мыши 
о9в Чтение данных из порта устройства мыши 


Последние две подфункции (085 и 09ъ) являются необязательными и могут 
не поддерживаться конкретным устройством мыши. 


Рассмотрим подробнее каждую подфункцию. 


2.2.1. Подфункция 00В 


Данная подфункция предназначена для включения или выключения уст- 
ройства мыши. Она является обязательной для всех устройств Р5/2. 


Глава 2. Мышь .45 


Использование: 
1. В регистр Ах следует поместить полный код функции, равный с200,. 


2. В регистр вн заносится значение операции: 005 (выключить) или 015 
(включить). | 


3. Вызывается прерывание В1О$ 11 151. 
Выход: 


После выполнения функции следует проверить флаг ск. В случае возникно- 
вения ошибки флаг будет установлен в 1, ав регистр Ан будет помещен код 
ошибки. Возможные коды ошибок перечислены в табл. 2.5. 


Таблица 2.5. Коды ошибок 


Код ошибки Описание 


о0в Операция успешно завершена 

Оль Недопустимый номер функции (подфункции) 

025 Использование недопустимых значений параметров (например, ввод 
значения 04ь в регистр вн) 

Зы Ошибка в интерфейсе Р$/2 

04в Требуется повторить передачу данных для устройства мыши 

058 Отсутствует необходимый обработчик (драйвер) мыши 


Приведу простой пример использования нодфункции 00» для запрещения 
работы мыши (листинг 2.1). 





поу АХ, 0С2000; помещаем в регистр АХ номер функции 


поу ВН, ООН ; заносим нулевое значение для отключения мыши 
106 150 ; вызываем прерывание ВТО$ 
)с ЕггогНпа ; если произошла ошибка, вызываем обработчик 


2.2.2. Подфункция 078 


Подфункция о1ь прелназначена для сброса мыши Р5/2. Она является обяза- 
тельной для всех устройств Р5/2. 


Использование: 
1. В регистр Ах следует поместить полный код функции, равный с201в. 
2. Вызвать прерывание ВО$ 1пе 153. 
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Выход: 

После выполнения функции следует проверить флаг се. В случае возникно- 
вения ошибки флаг будет установлен в |, а в регистр Ан будет помещен код 
ошибки. Возможные коды ошибок перечислены в табл. 2.5. Если функция 
завершена ‘успешно, флаг сг очищен, а регистр вх будет содержать следую- 
щее значение: старший байт регистра (вн) — идентификатор устройства (как 
правило, 00з), младший байт регистра (вт) — возвращаемое значение (для 
мыши Р5$/2 равно ААВ). 


Простой пример использования подфункции 01ь для сброса устройства 
мыши показан в листинге 2.2. 


Листинг 2. 2. Использование подфункции отв 


то\ АХ, 0С2018; помещаем в регистр АХ номер функции 

106 158 ; вызываем прерывание ВТО 

с ЕтхогНпА ; если произошла ошибка, вызываем обработчик 
стр ВЬ, ОААН ; проверяем, если нужно, возвращаемое значение 


2.2.3. Подфункция 028 


Данная подфункция предназначена для установки частоты дискретизации 
мыши Р5/2. 


Использование: 


1. В регистр Ах следует поместить полный код функции, равный с2025. 


5) 


В регистр вн заносится значение кода для частоты дискретизации. Воз- 
можные значения представлены в табл. 2.6. 


3. Вызывается прерывание В1О0$ 1пе 151. 


Таблица 2.6. Значения кодов частоты дискретизации 


Значение кода Частота дискретизации, выборок/сек 
ов 10 
Отн 20 
026 40 
ов 60 
04Н 80 
055 100 


обв 200 
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Выход: 


После выполнения функции следует проверить флаг ск. В случае возникно- 
вения ошибки флаг будет установлен в 1, а в регистр дн будет помещен кол 
ошибки. Возможные коды ошибок перечислены в табл. 2.5. 


Рассмотрим небольшой пример использования функции с202в для установ- 
ки максимального значения частоты дискретизации мыши Р5/2. К слову. 
эта операция существенно улучшит работу мыши, особенно в графических 
и чертежных программах. В листинге 2.3 показан пример работы с данной 
подфункцией. 


"Листинг 2.3. Использование подфункции 025 








поу АХ, 0С2025; помещаем в регистр АХ номер функции 

поу ВН, Об ; частота дискретизации 200 выборок в секунду 
106 156 ; вызываем прерывание ВТО$ 

)с ЕккохНпа ; если произошла ошибка, вызываем обработчик 


2.2.4. Подфункция ОЗВ 


Подфункция предназначена для управления разрешением (чувствитель- 
ностью) мыши Р5/2. 


Использование: 
1. В регистр Ах следует поместить полный код функции, равный с203ь. 


2. В регистр вн заносится значение кода для устанавливаемого разрешения. 
Возможные значения представлены в табл. 2.7. 


3. Вызывается прерывание В10$ {пе 158. 


Таблица 2.7. Значения кодов разрешения 


Значение кода Разрешение, отсчетов/мм 
сов 1 
01В 2. 
028 4 
озь 8 


Выход: 


После выполнения функции следует проверить флаг сг. В случае возникно- 
вения ошибки флаг будет установлен в 1, а в регистр дн будет помещен код 
ошибки. Возможные коды ошибок перечислены в табл. 2.5. 
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Простой пример использования подфункции. 03ь для установки нового раз- 
решения мыши показан в листинге 2.4. 





Листинг 2.4. Использование подфункции оЗь 


пох АХ, 0С2031; помещаем в регистр АХ номер функции 

поу ВН, 011 ; разрешение 2 отсчета на один миллиметр 

106 156 ; вызываем прерывание ВТО$ 

с ЕткогНпа ; если произошла ошибка, вызываем обработчик 


2.2.5. Подфункция 048 


Подфункция 04в служит для получения идентификатора устройства, по ко- 
торому можно определить тип подключенного устройства. 


Использование: 
1. В регистр Ах следует поместить полный код функции, равный с204н. 


2. Вызвать прерывание В1О$ 1п- 15ъ. 


Выход: 


После выполнения функции следует проверить флаг СЕ. В случае возникно- 
вения ошибки флаг будет установлен в 1, а в регистр дн будет помещен код 
ошибки. Возможные коды ошибок перечислены в табл. 2.5. Если ошибок 
нет, флаг се будет очищен, а в старший байт регистра вх будет помещено 
значение идентификатора. 


Пример использования подфункции 045 для получения идентификатора 
устройства мыши показан в листинге 2.5. 


‚ Листинг 2.5. Использование подфункции 046 

Туретр 4 ? ; переменная для хранения идентификатора мыши 
... ; общий код программы 

по\У АХ, 0С204Н; помещаем в регистр АХ номер функции 

116 15. ; вызываем прерывание ВТО$ 


с ЕгкогНра ; если произошла ошибка, вызываем обработчик 
поу Туретр, ВН; помещаем полученное значение идентификатора в переменную 


2.2.6. Подфункция 05Р 


Данная подфункция предназначена для инициализации интерфейса мыши 
Р$/2. После ее выполнения устройство мыши будет иметь следующие пара- 
метры: выключено, разрешение — 4 отсчета на миллиметр, частота дискре- 
тизации — 100 выборок в секунду, масштабирование — 1:1. 
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Использование: 

1. В регистр Ах следует поместить полный код функции, равный с2051. 
2. В регистр вн заносится размер пакета данных (от 1 до 8 байтов). 

3. Вызывается прерывание В1О$ 1пе 155. 


Выход: 


После выполнения функции следует проверить флаг сЕ. В случае возникно- 
вения ошибки флаг будет установлен в 1, ав регистр Ан будет помещен код 
ошибки. Возможные коды ошибок перечислены в табл. 2.5. Простой при- 
мер использования Подфункции 05в для инициализации мыши показан в 
листинге 2.6. 


Листинг 2.6. Использование подфункции 055 
поу АХ, 0С2051; помещаем в регистр АХ номер функции 
поу ВН, О8В ; размер пакета данных 


116 156 ; вызываем прерывание ВТО$ 
)с ЕхгогНПа ; если произошла ошибка, вызываем обработчик 


2.2.7. Подфункция 068 


Подфункция предназначена для передачи устройству мыши Р5/2 расширен- 
ной команды. Под расширенной командой понимается одна из трех воз- 
можных операций: определение состояния устройства, установка масштаби- 
рования в 1:1, установка масштабирования в 2: |. 


Использование: 
1. В регистр Ах следует поместить Полный код функции, равный с206%. 


2. В регистр вн заносится код расширенной команды. Возможные значения 
представлены в табл. 2.8. 


3. Вызывается прерывание В1О$ 1пь 151. 


Таблица 2.8. Значения кодов расширенной команды 


Код команды — Описание 


00в Возвратить состояние устройства 
о2ь Установить масштаб 1: 1 
02. Установить масштаб 2: 1 


Выход: 


При использовании кода расширенной команды, равного 015 или 025, сле- 
дует проверить флаг сг. В случае возникновения ошибки флаг будет уста- 
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новлен в |1, ав регистр Ан будет помешен код ошибки. Возможные коды 
ошибок перечислены в табл. 2.5. Если же использовалась расширенная 
команда с кодом оон, тогда младший байт регистра вх будет содержать бито- 
вую маску состояния устройства (табл. 2.9), младший байт регистра сх — 
текущее разрешение (см. табл. 2.7); а младший байт регистра ох — текушую 
частоту дискретизации (см. табл. 2.6). 


Таблица 2.9. Битовая маска состояния устройства 


Бит Описание 

Статус правой кнопки (1 — нажата, 0 — отпущена) 
Статус средней кнопки (1 — нажата, О — отпущена) 
Статус левой кнопки (1 — нажата, 0 — отпущена) 
Зарезервирован 

Масштаб (1 для 1:1, 0 для2: 1) 

Состояние устройства (1 — включено, 0 — выключено) 


Режим работы (1 — дистанционный, 0 — потоковый) 


чо тол -о 


Зарезервирован 


Пример использования подфункции о6вь для установки масштаба 2:1 уст- 
ройства мыши показан в листинге 2.7. 





Листинг 2.7. Использование подфункции 066 








поу АХ, 0С206.; помещаем в регистр АХ номер функции 
поу ВН, 021 ; код расширенной команды (масштаб 2:1) 


116 15. ; вызываем прерывание ВТО$ 
< ЕгхтогНаа ; если произошла ошибка, вызываем обработчик 


2.2.8. Подфункция 07В 


Подфункция 075 позволяет указать новый адрес обработчика прерываний 
для устройства мыши Р$/2. 

Использование: 

1. В регистр Ах следует поместить полный код функции, равный с207ь. 


2. В гз:вн заносится дальний указатель (ЕАв) на собственный обработчик. 
Для отмены пользовательского обработчика следует указать значение 
0000ъ:0000Ъ. 


3. Вызывается прерывание ВОЗ 1пе 158. 


Глава 2. Мышь 51 


Выход: 


После выполнения функции следует проверить флаг сг. В случае возникно- 
вения ошибки флаг будет установлен в |, а в регистр Ан будет помещен код 
ошибки. Возможные коды ошибок перечислены в табл. 2.5. 


Простой пример использования подфункции о7н для инициализации мыши 
показан в листинге 2.8. 





поУ АХ, осоть; помещаем в регистр АХ номер функции 

1ез ВХ, МуНапа; указываем адрес и смещение нашего обработчика 
116 156 ; вызываем прерывание ВТО$ 

с ЕкгоЕНпА ; если произошла ошибка, вызываем обработчик ошибок 


2.2.9. Подфункция 08 


Данная подфункция предназначена для записи в порт устройства любого 
значения размером в один байт. Данная подфункция является необязатель- 
ной и может не поддерживаться стандартными устройствами мыши Р5$/2. 
Использование: 

1. В регистр АХ следует поместить полный код функции, равный с208в. 


2. В регистр вт, записывается значение передаваемого байта. 
3. Вызывается прерывание В1О$ 1пе 158. 

Выход: 

Проверка возвращаемого значения не определена. 


Хотя эта подфункция и не имеет серьезных шансов на практическое ис- 
пользование, приведу простой пример ее использования в листинге 2.9. 


поу АХ, 0С2081; помещаем в регистр АХ номер функции 
поу ВЫ, 641 ; записываем в порт значение 100 
116 151 ; вызываем прерывание ВТО$ 


2.2.10. Подфункция ОЭН 


Подфункция предназначена для чтения из Порта устройства текущей ин- 
формации из трех байт о состоянии мыши. Данная подфункция является 
необязательной и может не поддерживаться стандартными устройствами 
мыши Р5$/2. 
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Использование: 
1. В регистр Ах следует поместить полный код функции, равный с209н. 


2. Вызывается прерывание В1О$ 1пе 151. 


Выхол: 


После завершения подфункции информация будет распределена следующим 
образом: вр, — первый байт, ст, — второй байт и рт, — третий байт. 


Простой пример использования подфункции 07н для инициализации мыши 
показан в листинге 2.19. 





` Листинг 2.10. Использование подфункции 095 


Збафт 1 4 ? ; переменная для хранения первого байта 

ЗкаЕ 2 46 ? ; переменная для хранения второго байта 

эта 4 ? ; переменная для хранения третьего байта 
; общий код программы 

поу АХ, 0020921; помещаем в регистр АХ номер функции 

11 156 ; вызываем прерывание ВТО$ 

ПОУ ЗЕае_1, ВЬ; сохраняем полученную информацию 

поу экае_2, сь 

поу Эфае_3, ОБЬ 


На этом можно заверигить рассмотрение средств В1О$ по управлению уст- 
ройством мыши Р$/2. Информация довольно скудная, что связано с отсут- 
ствием какой-либо полноценной документации по данному вопросу. Для 
тех, кто пишет программы под 0ОО$, могу посоветовать самостоятельно 
ознакомиться с набором соответствующих функций (с использованием пре- 
рывания 116 335), поддерживающих работу мыши. 


2.3. Использование портов 


Доступ к устройству посредством аппаратных портов всегда был и останется 
самым мощным и универсальным. Он дает возможность непосредственно 
обратиться к контроллеру мыши, интегрированному на материнской плате. 
Самыми важными его преимуществами являются следующие: 


О поддержка любых новых возможностей, появляющихся в расширениях 
стандарта; 


О отсутствие обращений к прерываниям В10$ и РО$5; 
С заметное повышение скорости в приложениях реального времени. 
Наряду с достоинствами, есть и несколько недостатков: 





С необходимо отличное знание самого устройства и наличие документации 
к нему; 
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О полный учет всех возможных вариантов взаимодействия по требуемому 
протоколу; 


О владение языком АззетЫег или С (С++). К сожалению, современные 
языки (\У1зиа| Вас, С#, реарм, Тауа и т. д.) все дальше и дальше "уводят" 
начинающих программистов от интересного, но сложного, к более про- 
стому, но очень ограниченному. 


Мне бы хотелось рассмотреть документированные способы работы с мышью 
Р$/2. Еще раз напомню, что информации по данной теме очень мало, и 
здесь представлена вся имеющаяся в свободном доступе. 


Итак, для непосредственной работы с мышью Р5/2 используются два порта 
контроллера клавиатуры, адресуемые через регистры бав и вов. Регистр 64ь 
имеет двойное назначение. В режиме чтения он служит регистром статуса и 
позволяет получить текущую информацию о состоянии мыши. Этот регистр 
имеет размер 8 бит и представлен в табл. 2.10. 


Таблица 2.10. Регистр состояния (645) 


Бит Описание 


0 Наличие данных в выходном буфере мыши (0 — выходной буфер пустой, 
1 — в буфере есть данные) 


1 Наличие данных во входном буфере мыши (0 —.входной буфер пустой, 
1 — в буфере есть данные) 


2 Результат самотестирования (0 — сброс, 1 — тест прошел успешно) 


к Использование портов контроллером клавиатуры (0 — запись в порт в0ъ, 
1 — запись в порт 645) 


4 Состояние клавиатуры (0 — заблокирована, 1 — включена) 


5 Наличие данных в выходном буфере мыши (0 — выходной буфер пустой, 
1 — в буфере есть данные) 


6 Ошибка тайм-аута (0 — ошибка отсутствует, 1 — ошибка). В случае ошибки 
следует повторить передачу данных, используя команду везепа 


7 Ошибка четности (0 — ошибка отсутствует, 1 — ошибка) указывает 
на последнюю ошибку, произошедшую при передаче данных 


В режиме записи регистр 64в служит для передачи команд контроллеру кла- 
виатуры. Через запись в этот регистр команды осуществляется управление 
контроллером клавиатуры. Назначения битов в командном регистре пере- 
числены в табл. 2.11. 


Список команд, используемых для мыши Р3/2, перечислен в табл. 2.12. 











54 Часть |. Работа с аппаратными ресурсами в И/паомиз 
Таблица 2.11. Регистр команд (641) 
Бит Описание 
0 Прерывания для клавиатуры (0 — отключить, 1 — включить) 
1 Прерывания для мыши (0 — отключить, 1 — включить) 
2 Системный флаг (1 — инициализация через самотестирование, 
0 — инициализация по питанию) 
3 Не используется 
4 — Доступ к клавиатуре (0 — открыт, 1 — закрыт} 
5 — Доступ к мыши (0 — открыт, 1 — закрыт) 
6 Трансляция скан-кодов (0 — не использовать, 1 — использовать) 
7 Резерв 
Таблица 2.12. Команды управления для мыши 
моды Описание 
208 Прочитать регистр команд 
60 Записать байт в регистр команд 
АТВ Отключить порт мыши Р$/2 
АВВ Включить порт мыши Р$/2 
АЭВ Выполнить самотестирование мыши (байт на выходе равен оон) 
ААВ Выполнить самотестирование контроллера (байт на выходе равен 555) 
сов Прочитать входной порт 
св Скопировать из входного порта младший разряд байта 
С2В Скопировать из входного порта старший разряд байта 
ров Прочитать расширенную информацию для выходного порта (0 бит — 
сброс процессора, 1 бит — канал А20 включен, 2 бит — передача дан- 
ных от мыши Р5/2, 3 бит — синхросигнал от мыши Р5/2, 4 бит — выход- 
ной буфер заполнен, 5 бит — выходной буфер мыши Р$/2 заполнен, 
6 бит — синхросигнал для клавиатуры, 7 бит- передача данных от 
клавиатуры) 
р Записать байт данных в выходной порт 
ЗВ Записать байт данных в выходной буфер мыши Р$/2 
РАВ Записать байт данных для мыши Р$2 
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Для обмена данными с мышью используется регистр 60ъ, называемый реги- 
стром данных. После выполнения какой-либо команды в данный регистр 
помещается код ошибки, по которому можно судить о результате операции. 
Возможные значения кодов ошибок представлены в табл. 2.13. Если коман- 
да управления является расширенной (имеет размер два байта), то первый 
байт команды должен быть записан в командный регистр, а второй байт — 
в регистр данных. 


Таблица 2.13. Коды ошибок мыши 


Код ошибки Описание 


ААВ Самотестирование контроллера успешно выполнено 
КА, Команда успешно передана 

ЕСВ Ошибка самотестирования мыши 

РЕВ Запрос на повторную передачу данных (команда везепа) 


После того, как были рассмотрены основные команды контроллера клавиа- 
туры для управления устройством мыши Р5/2, приведу несколько примеров 
их использования. Пример кода, позволяющий протестировать интерфейс 
мыши Р5$/2, показан в листинге 2.11. 





Листинг 2.41. Тестирование интерфейса мыши Р$/2 

@гереас: 

11 АБ, 646 ; получаем состояние порта 

апа АТ, 105 ; проверяем наличие панных во входном буфере 
12 @гереаЕ ; буфер занят, пытаемся повторить запрос 

поу АГ, АЭП ; запишем команду самотестирования 


сиё 641, АБ ; запишем значение в командный регистр 
11 АГ, 641 ; проверяем регистр состояния 





апа АБ, 201 ; успешно ли передана команда 
312 ЕггогНпа; если нет, передаем управление обработчику ошибок 


Этот же пример для С++ показан в листинге 2.12. 

Листинг 2.12. Тестирование интерфейса мыши Р$/2 в С++ 
ОИОКР ЧиВези1Е = 0; // переменная для хранения результата 

116 1Тлема1еЕ = 50000; 


// проверяем наличие данных во входном буфере 
и111е ( -- 1Тьмема1а > 0) 
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// читаем состояние порта 

1пРог® ( 0х64, &ОмВезо1%, 1); 

1Е ( (ЗмВезоа1е & 0х02) == 0х00) Бхеак; 

// закончилось время ожидания 

1Е ( 1Тлема1Е < 1) гебогп МУ ЕВВОВ_ТТМЕ; 
} 
// записываем в порт команду самотестирования 
оиЕРогЕ ( 0х64, ОхАЭ, 1); 
1Тилема1е = 50000; 
// проверяем, успешно ли передана команда 
\611е ( -- 1Тлема1е > 0) 
{ 

// читаем состояние порта 

1пРогЕ ( 0х64, &мВези1е, 1); 

1Е ( (ЗмВезо1Е & 0х02) == 0х00) Югхеак; 

// закончилось время ожидания 

1Е ( 1ТьлеМа1е < 1) гебогп МУ ЕВВОВ _ТТМЕ; 
} 


// самотестирование мыши успешно завершено 


Если вы заметили, мы постоянно проверяем регистр статуса (бит 2) на на- 
личие данных во входном буфере. В реальных программах дополнительно 
следует проверять ошибки тайм-аута (бит 6) и четности (бит 7). 


Рассмотрим еще один пример, позволяющий программно отключить мышь 
Р$/2 (листинг 2.13). 


Листинг 2.13. Отключение мыши Р$/2 





@тереаф: 

10 АБ, 64. ; получаем состояние порта 

апа АЬ, 10 ; проверяем наличие данных во входном буфере 

12 @гереаЕ ; буфер занят, пытаемся повторить запрос 

поу АЬ, АТВ ; запишем команду отключения мыши 

оиЕ 64Н, АБ ; запишем значение в командный регистр 

11 АБ, 646 ; проверяем регистр состояния 

апа АБ, 205 ; успешно ли передана команда 

)п= ЕгкогНПЯ; если нет, передаем управление обработчику ошибок 


Этот же пример для С-+- представлен в листинге 2.14. 





ОИОВО ФмВезо1Е = 0; // переменная для хранения результата 
1пЕ 1Т1мема1Е = 50000; 
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// проверяем наличие данных во входном буфере 
ип11е ( -- 1Тилема1е > 0) 
{ 

// читаем состояние порта 

1пРогЕ ( 0х64, &ЧмВезо1е, 1); 

1Е ( (ЧмВезо1% & 0х02) == 0х00) Бгеак; 

// закончилось время ожидания 

1Е ( 1Тьлема1е < 1) гебакр МУ ЕВВОВ ТТМЕ; 
} 
// записываем в порт команду отключения мыши Р$/2 
сиЕРогЕ ( 0х64, ОхАТ, 1); 
1ТеМа1е = 50000; 
// проверяем, успешно ли передана команда 
мв1е ( -- 1Тлема1е > 0) 
{ 

// читаем состояние порта 

1пРогЕ ( 0х64, &ОмВезо1е, 1); 

1Е ( (амВезо1Е & 0х02) == 0х00) БгеакК; 

// закончилось время ожидания 

1Е ( 1Тьлема1е < 1) гебагр МУ ЕВВОК_ТТМЕ; 
} 


// мышь успешно заблокирована 


В обоих примерах используются команды управления контроллером клавиа- 
туры, но лля мыши Р5/2 существует еще дополнительный набор команд, 
разработанный специально для нее. Некоторые производители мышей могут 
добавлять свои специфические команды, которые можно найти в техниче- 
ской документации, предоставляемой разработчикам. Список всех стан- 
дартных команд для мыши Р5/2 приведен в табл. 2.14. 


Таблица 2.14. Набор команд для мыши Р$/2 


Код команды Описание 


РЕВ Везее 

КЕБ Везепа 

ЕбВ Зее РеЁац15 

РЭВ 21заб1е 

КАБ Епаб1е 

ЕЗВ Зеё Запр1е Вафе 
Е2В ВеаЯ Пе\у1се Туре 


ков Зее Вепобе Моде 
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Таблица 2.14 (окончание) 


Код команды Описание 


ЕБЕВ ЗеЕ Игар Моде 
ЕСВ Везее Игар Моде 
ЕВВ ВеаЯ Рафа 

БАБ ЗеЕ 5&геам Моае 
Е9В ЗЕасаз Веацезе 
Е8В ЗеЕё Везо1ае10п 
Е7В Зее $са11п4а 2:1 
ЕбВ Зеё Зса11па 1:1 


Процесс вызова каждой дополнительной команды Р$/2 немного отличается 
от прямого управления контроллером клавиатуры. Вначале выполняется 
команда р4н (записать байт данных для мыши Р$2), и только потом в ре- 
гистр данных записывается код команды мыши Р5/2 (например, ЕЕВ для 
сброса мыши). Говоря проще, каждая дополнительная команда Р5/2 имеет 
размер два байта (оаь и любой код команды), где первый байт записывается 
в регистр команд (64.), а второй — в регистр данных (605). Если команда 
Р$/2 требует передачи дополнительных данных (например, нового значения 
частоты дискретизации), то эта информация должна быть записана в ре- 
гистр данных (601), а первый байт о4в также записывается в командный ре- 
гистр. Далее будут приведены примеры использования команд Р5$/2, где 
можно будет наглядно убедиться в этом. А теперь рассмотрим набор команд 
управления мышью Р5/2 более подробно. 


2.3.1. Команда Аезе (РЕН) 


Данная команда предназначена для программного сброса устройства мыши 
Р$/2. После успешного выполнения команды (через 300—500 мс) мышь 
возвращает код ЕАВ и комбинацию длн и 008. После этого мышь устанавли- 
вает режим сброса. В листинге 2.15 приводится упрощенный пример кода 
для программного сброса мыши Р$/2. 


: Листинг 2.15. Выполнение сброса контроллера мыши Р$/2 





@уереа*: 

101 АБ, 648 ; получаем состояние порта 

апЯ АГ, 10Ъ ; проверяем наличие данных во входном буфере 
12 @гереаЕ ; буфер занят, пытаемся повторить запрос 





оу АТ, 0046; запишем команду передачи байта 
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оц 645, АБ ; запишем значение в командный регистр 

11 АБ, 646 ; проверяем регистр состояния 

апа АГ, 20. ; успешно ли передана команда 

)п2 ЕггогНпЯ; если нет, передаем управление обработчику ошибок 
поу АБ, ЕЕП ; запишем код команды Везее 

оц 605, АБ ; в регистр данных 

11 АБ, 64В ; проверяем регистр состояния 

апа АГ, 20В ; успешно ли передана команда 

]п12 ЕггогНпЯ; если нет, передаем управление обработчику ошибок 


Дополнительно, после выполнения команды сброса можно проверить ре- 
гистр е0ъ на наличие кода гАЬ. Аналогичный пример для С++ показан в 
листинге 2.16. 


Листинг 2.16. Выполнение сброса контроллера мыши Р$/2 в С++ 








ОМОВО 9мВези1Е = 0; // переменная для хранения результата 
106 1Тема1{ = 50000; 
// проверяем наличие данных во входном буфере 
м811е ( -- 1Тплема1 > 0) 
{ 
// читаем состояние порта 
1пРогЕ ( 0х64, &ЧмВеза1е, 1); 
1Е ( (ЗмВезо1е & 0х02) == 0х00) Бтеак; 
// закончилось время ожидания 
1Е ( 1Тлема1е < 1) гебагп МУ ЕВКОВ _ТТМЕ; 
} 
// записываем в порт команду передачи данных 
оцЕРогеЕ ( 0х64, 0хр4, 1); 
1ТШщема1е = 50000; 
/! проверяем, успешно ли передана команда 
м111е ( -- 1Тлема1е > 0) 
{ 
// читаем состояние порта 
1пРог® ( 0х64, &ЧмВезоа1*, 1); 
1Е ( (ЗмВеза1 & 0х02) == 0х00) Бхеак; 
// закончилось время ожидания 
1Е (`1ТиеМа1е < 1) гебагп МУ ЕВВОВ ТТМЕ; 
} 
// записываем в порт команду Везее 
оцЕРоге ( 0х60, ОхЕЕ, 1); 
1Т1еМа1 = 50000; 


60 Часть |. Работа с аппаратными ресурсами в И/тао\/$ 


// проверяем, успешно ли передана команда 
\р11е ( -- 1Тулема1е > 0) 
{ 
// читаем состояние порта 
1пРогЕ ( 0х64, &мВези1е, 1); 
1Е ( (амВезо14 & 0х02) == 0х00) огеак; 
// закончилось время ожидания 
1Е ( 1Т\леМа1е < 1) гебакр МУ ЕВВОК_ТТМЕ; 
} 


'/ программный сброс мыши завершен 


2.3.2. Команда Ае5ела (РЕН) 


Команда предназначена для проверки данных, поступивших от мыши. 
Компьютер посылает эту команду, если переданные от мыши данные имеют 
недопустимое значение. Получив ее, мышь выполняет повторную передачу 
последнего пакета данных. Если данные опять ошибочны, компьютер может 
повторить запрос командой везепа либо выполнить программный сброс 
командой Везек. В любом случае регистр данных (608) будет содержать 
значение ЕАВ. 


2.3.3. Команда Зе! Бе!зий$ (ЕбН) 


Команда позволяет установить все параметры мыши, используемые по 
умолчанию. После записи в регистр данных кода гАВ мышь установит сле- 
дующие значения: масштаб — 1:1, разрешение — 4 отсчета на миллиметр, 
частота дискретизации — 100 выборок и потоковый режим. 


2.3.4. Команда О/5аЫе (Е 51) 


Данная команда позволяет отключить обмен данных между мышью и ком- 
пьютером в потоковом режиме. Кроме этого, все счетчики движения сбра- 
сываются в нулевое состояние. При этом все другие операции могут осуще- 
ствляться. Выполнение команды подтверждается записью в регистр данных 
кода ЕАН. 


2.3.5. Команда ЕлаЫе (Е4В) 


Команда позволяет продолжить передачу данных между мышью и компью- 
тером, если установлен потоковый режим. Выполнение команды подтвер- 
ждается записью в регистр данных кода ЕАЪ. 
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2.3.6. Команда $еЕ батр/е ВаЕе (Е ЗП) 


Команда позволяет установить частоту дискретизации для мыши Р5/2. 
Команда является двухбайтовой. Вначале в регистр данных записывается 
код команды ЕЗв. Мышь подтверждает получение команды записью в ре- 
гистр данных кода гАБ. После этого в регистр данных записывается второй 
байт команды, который содержит значение частоты дискретизации. Мышь 
вторично подтверждает получение, записав в регистр данных код ЕАЬ. Воз- 
можные значения частоты дискретизации перечислены в табл. 2.6. Для луч- 
шего понимания работы с данной командой приведу пример ее использова- 
ния в листинге 2.17. 


"Листинг 2.17. Установка частоты дискретизации для мыши Р$/2 








1 АБ, 646 ; получаем состояние порта 


апа АГ, 106 ; проверяем наличие данных во входном буфере 
)12 @гереаЕ ; буфер занят, пытаемся повторить запрос 

поу АБ, ОО4В; запишем команду передачи байта 

оцЕ 641, АБ ; запишем значение в командный регистр 

1 АБ, 64В ; проверяем регистр состояния 

апа АГ, 205 ; успешно ли передана команда 

322 ЕггогНга; если нет, передаем управление обработчику ошибок 
поу АБ, ЕЗНЬ ; запишем код команды беЕ батр1е Кафе 

сое 601, АШ ; в регистр данных 

1 АБ, 646 ; проверяем регистр состояния 

апа А, 20. ; успешно ли передана команда 

)12 ЕгкогНПа; если нет, передаем управление обработчику ошибок 
@гереае2: 

ш АБ, 646 ; получаем состояние порта 

апа АГ, 106 ; проверяем наличие данных во входном буфере 

302 @гереа®2; буфер занят, пытаемся повторить запрос 

поу АГ, 004П; запишем команду передачи байта 





опЕ 645, АГ ; запишем значение в командный регистр 

11 АБ, 64 ; проверяем регистр состояния 

апа АЬ, 201 ; успешно ли передана команда 

302 ЕггогНоа; если нет, передаем управление обработчику ошибок 
поу АБ, 64 ; запишем новое значение частоты 100 выборок 

сиё 608, АБ ; в регистр данных 

2 АБ, 641 ; проверяем регистр состояния 

апа АЬ, 201 ; успешно ли передана команда 

12 ЕггогНпа; если нет, передаем управление обработчику ошибок 
1 АБ, 60Б ; проверяем наличие кода ГАВ 

сир АБ, ОРАЛ; в регистре данных . 

]02 ЕггогхНПЯ; если нет, передаем управление обработчику ошибок 
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Этот же код для С++ представлен в листинге 2.18. 


Листинг 2.18. Установка частоты дискретизации для мыши Р$/2 в С++ 





ОМОВО ЧмВези1Е = 0; // переменная для хранения результата 
1пЕ 1ТплеМа1Е = 50000; 
// проверяем наличие данных во входном буфере 
у11е ( -- 1Т1лмемал® > 0) 
{ 

// читаем состояние порта 

1пРогЕ ( 0х64, &ЧмВезафе, 1); 

1Е ( (ЗмВеза1Е & 0х02) == 0х00) хгеак; 

// закончилось время ожидания 

1Е ( 1Тлема1Е < 1) гебагп МУ ЕВВОВ ТТМЕ; 
} 
// записываем в порт команду передачи данных 
опЕРогЕ ( 0х64, 0х4, 1); 
1Туиема1Е = 50000; 
// проверяем, успешно ли передана команда 
\р11е ( -- 1Т1мемат® > 0) 
{ 

// читаем состояние порта 

1пРогЕ ( 0х64, &ЧмВези1е, 1); 

1Е ( (ЧиВеза1 & 0х02) == 0х00) ьгеак; 

// закончилось время ожидания 

1Е ( 1ТумемазЕ < 1) гебагр МУ ЕВВОВ_ ТТМЕ; 
} 
// записываем в порт команду Зеф Зашр1е Вафе 
очЕРогЕ ( 0х60, 0ОхЕЗ, 1); 
1Тнлема1е = 50000; 
// проверяем, успешно ли передана команда 
У11е ( -- 1ТилеМа1е > 0) 
{ 

// читаем состояние порта 

1оРогЕ ( 0х64, &амВеза1е, 1); 

1Е ( (ЧмВезо1Е & 0х02) == 0х00) огеак; 

// закончилось время ожидания 

1Е ( 1Тумема1Е < 1) гебагп МУ _ЕВВОВ_ТТМЕ; 
} 
// записываем в порт команду передачи данных 
опЕРогЕ ( 0х64, Охр4, 1); 
1Тилема1Е = 50000; 
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// проверяем, успешно ли передана команда 
ир11е ( -- 1Тшлемате > 0) 
{ 
// читаем состояние порта 
1оРогЕ ( 0х64, &ЧмВезо1е, 1); 
1Е ( (Ч4мВеза1 & 0х02) == 0х00) Ьгеак; 
.// закончилось время ожидания 
1Е ( 1Тлема1е < 1) гебагп МУ ЕВВОВ_ТТМЕ; 
} 
// записываем в порт новое значение частоты 100 выборок 
соЕРогЕ ( 0х60, 0х64, 1); 
1ТаеМа1е = 50000; 
// проверяем, успешно ли передана команда 
Пе ( -- 1Тулемале > 0) 
{ 
// читаем состояние порта 
1оРохгЕ ( 0х64, &ЧмВеза1%, 1); 
1Е ( (ЧиВези1 & 0х02) == 0х00) ргеак; 
// закончилось время ожидания 
1Е ( 1Т1лема1е < 1) гебагп МУ _ЕАКОВ_ТТМЕ; 
} 
// проверяем наличие кода ЕАБ в регистре данных 
1пРогЕ ( 0х60, &@мВези1%, 1); 
1Е ( Чмвеза1е != ОхЕА) 
хебагп МУ ЕВВОК; 
// новая частота дискретизации 100 выборок в секунду установлена 


2.3.7. Команда Яеа4 Оеугсе Туре (Е2Ё) 


Команда позволяет получить идентификатор устройства. Для мыши Р5/2 
это значение всегда равно 00р. Мышь подтверждает получение команды 
записью в регистр данных кода ЕАв. 


2.3.8. Команда $е! Лето{е Мосе (РоП) 


Данная команда позволяет включить дистанционный режим управления 
мышью Р5/2. Мышь подтверждает получение команды записью в регистр 
данных кода ЕАН. В этом режиме мышь передает данные на компьютер 
только после подачи последним запроса чтения с помощью команды ВВ. 


2.3.9. Команда $еЁ Игар Моде (ЕЕК) 


Команда позволяет установить эхо-режим для мыши Р5$/2. Мышь подтвер- 
ждает получение команды записью в регистр данных кода ЕАв. В этом ре- 
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жиме любой байт, кроме ЕЕВ (Везее) И ЕСВ (ВезеЕ Мхар Моде), будет возвра- 
щен устройством мыши на компьютер. 


2.3.10. Команда Резе! Игар Моде (ЕСК) 


Команда позволяет выйти из эхо-режима и восстановить прежний режим. 
Если передача данных в потоковом режиме была заблокирована коман- 
ДОЙ 01заЪ1е, то прежний режим не будет восстановлен. Кроме того, выпол- 
нение данной команды в любом другом режиме не будет иметь никакого 


результата. Мышь подтверждает получение команды записью в регистр дан- 
НЫХ КОДа КАБ. 


2.3.11. Команда Веаа Райа (ЕВК) 


Команда позволяет получить текущие значения счетчиков перемещения (по 
осям Х и У), а также информацию о состоянии кнопок. После успешной 
передачи данных счетчики перемешения сбрасываются в ноль. Мышь под- 
тверждает получение команды записью в регистр данных кода РАБ. Если 
мышь находится в дистанционном режиме, выполнение данной команды 
является единственным способом получения данных. 


2.3.12. Команда $е! Зеат Моде (ЕАН) 


Эта команда позволяет активизировать потоковый режим передачи данных 
для мыши Р5$/2. Мышь подтверждает получение команды записью в регистр 
данных кода кАк. В этом режиме данные от мыши поступают при любом 
движении или изменении состояния кнопок. 


2.3.13. Команда ${ашз Редиез1 (Е9Эв) 


Команда позволяет получить пакет данных (три байта) о текущем состоянии 
счетчиков движения и кнопок мыши Р5$/2. Формат данных представлен в 
табл. 2.15. Мышь подтверждает получение команды записью в регистр дан- 
ных кода гкАВ. Например, если выполнить команду Везеф, ТО 5+аеаз$ Ведаезе 
возвратит 4 байта в следующей очередности: ЕАЪ, 00, 025 и 64в. Первый 
байт указывает на завершение команды, второй байт — масштаб 1:1, при- 
нятый по умолчанию, третий байт — разрешение 4 отсчета на миллиметр, и 
четвертый байт — частоту дискретизации 100 выборок в секунду. 


В табл. 2.15 введены следующие обозначения: 


0 Правая кнопка. Определяет состояние правой кнопки мыши: | — кнопка 
нажата, 0 — кнопка отпущена. 


0 Средняя кнопка. Определяет состояние средней кнопки мыши: | -— 
кнопка нажата, 9 — кнопка отпущена. 
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0 Левая кнопка. Определяет состояние левой кнопки мыши: | — кнопка 
нажата, 0 — кнопка отпущена. 


О Масштаб. Определяет текущий режим масштабирования: 1 — режим 2:1, 
О: 1 

О Передача. Определяет передачу данных для потокового режима: 1 — пе- 
редача разрешена, 0 — передача запрещена. 


О Режим. Определяет текущий режим работы мыши: {1 — дистанционный, 
0 — потоковый. 


О Разрешение. Определяет текущее разрешение мыши. Может принимать 
значение от он до 35. 


О Частота дискретизации. Определяет текушую частоту дискретизации 
мыши. Может принимать значение от 10 до 200. 


Таблица 2.15. Формат данных состояния мыши 


Частота дискретизации 





Для наглядности приведу простой пример использования команды 
З6акиз Веааез® в листинге 2.19. 





{ас 1 ар ? ; переменная для хранения первого байта состояния 


зтас_2 96 ? ; переменная для хранения второго байта состояния 
зтас 3 6 ? ; переменная для хранения третьего байта состояния 
... ; общий код программы 

@гереа®: 


11 АБ, 641 ; получаем состояние порта 

апа АГ, 106 ; проверяем наличие данных во входном буфере 
)22 @гереас ; буфер занят, пытаемся повторить запрос 

поу АБ, ОО4р ; запишем команду передачи байта 

оцЕ 641, А. ; запишем значение в командный регистр 

10 АБ, 642 ; проверяем регистр состояния 

апа АЬ, 20. ; успешно ли передана команда 


02 ЕгкохНпа ; если нет, передаем управление обработчику ошибок 
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поу АТ, ОЕЭП ; запишем код команды З$абоз Веацезе 


оц 601, АЪШ ; в регистр данных 
@гереаЕ2: 

11 АЬ, 641 ; получаем состояние порта 
апа АГ, 201 ; проверяем данные 


302 @гереаЕ2 ; если данных нет, повторяем 

11 АБ, 601 ; получаем код завершения ГАВБ 

стр АБ, ОГАБ ; если код отсутствует 

312 ЕггогНоЯ ; передаем управление обработчику ошибок 





@гереа%3З: 

32 АБ, 6441 ; получаем состояние порта 

апа АГ, 201 ; проверяем данные 

912 @гереаЕ3 ; если данных нет, повторяем 

1п АБ, 601 ; получаем первый байт состояния 
шоу эзтафс 1, АГ; сохраняем в переменной зкафе 1 
@гереаЕ4: 

11 АБ, 641 ; получаем состояние порта 

апа АГ, 201 $; проверяем данные 

п? @гереаЕ4 ; если данных нет, повторяем 

11 АГ, 60. ; получаем второй байт состояния 
шоу зтас_2, АБ; сохраняем в переменной эфа®_2 
@гереаЪ5: 

11 АБ, 641 ; получаем состояние порта 


апа АТ, 20 ; проверяем данные 

)п17 @гереаф5 ; если данных нет, повторяем 

101 АЬ, 602 $; получаем третий байт состояния 
поу 5Сае 3, АГ; сохраняем в переменной зтаё 3 


Код упрощен для того, чтобы можно было легче понять принцип работы с 
управляющими командами. Например, циклы желательно делать конечны- 
ми, чтобы программа не зависла при отсутствии данных. Кроме того, может 
потребоваться запрешение прерывания мыши (смотрите описание регистра 
команд) перед вызовом управляющих команд, а после завершения работы — 
разрешение генерации прерываний. 


Аналогичный код получения состояния мыши для С++ показан в листин- 
ге 2.20. 





// переменная для хранения результата 

ОМОВР @мКезо1Е = 0; 

// переменные для хранения трех байтов текущего состояния мыши 
ВУТЕ Ю5%ап$ 1 = 0, Ь5фал$_2 = 0, Ю5%апз_ 3 = 0 

106 1Тиаема1 = 50000; 
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// проверяем наличие данных во входном буфере 
\р11е ( -- 1ТиаеМа1е > 0) 
{ 
// читаем состояние порта 
1пРог® { 0х64, &ОмВезо1е, 1); 
1Е ( (ЯВезо1Е & 0х02) == 0х00) Бгеак; 
// закончилось время ожидания 
1Е ( 1Типема1е < 1) гебогп МУ _ЕВВОК ТТМЕ; 
} 
// записываем в порт команду передачи данных 
оиЕРогЕ ( 0х64, 0х4, 1}; 
1ТипеМазе = 50000; 
// проверяем, успешно ли передана команда 
м811е ( -- 1Тиаемале > 0) 
{ 
// читаем состояние порта 
1пРОГЕ ( 0х64, &ЧмВезо1&, 1); 
1Е ( (ЭмВеза16 & 0х02} == 0х00} ргеаК; 
// закончилось время ожидания 
1Е ( 1Тилема1е < 1) гебагро МУ ЕВВОВ ТТМЕ; 
} 
// записываем в порт код команды 5$абаз Ведаезе 
ООЕРокгЕ ( 0х60, ОхЕ9, 1); 
1ТупеМа1е = 50000; 
// проверяем, успешно ли передана команда 
Уре ( -- 1Тиаемате > 0) 
{ 
// читаем состояние порта 
1пРОХЕ ( 0х64, &ЧмВезо1&, 1); 
1Е ( (ЭмВезц1% & 0х20)} == 0х00) ргеаКк; 
// закончилось время ожидания 
1Е ( 1Тилема1е < 1) гебагп МУ _ЕВВОК_ТТМЕ; 
} 
// проверяем код выполнения команды ГАБ 
1ПРОГЕ ( 0х60, &амВезо1, 1); 
1Е ( амВезо1Е != ОхЕА) 
тебагп МУ ЕВВОВ; 
// ожидаем данные 
1Темале = 50000; 
// проверяем, успешно ли передана команда 
м11]е ( -- 1Тлмемате > 0} 
{ 
// читаем состояние порта 
1пРоге ( 0х64, &ЧмВезо1Е, 1); 
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1Е ( (ЗмВезо1 & 0х20) == 0х00) ьгеак; 
// закончилось время ожидания 
1Е ( 1Томемайе < 1) кебаго МУ ЕВВОВ ТТМЕ; 
} 
// получаем первый байт состояния 
1оРогЕ ( 0х60, &ЧмВезо1%, 1); 
// сохраняем значение первого байта в переменной 
Ь5фалз_1 = (ВУТЕ) ЧмВезо1е; 
// ожидаем данные 
1Тлема1е = 50000; 
// проверяем, успешно ли передана команда 
\р11е ( -—- 1Тилемале > 0) 
{ 
// читаем состояние порта 
10РогЕ ( 0х64, &амВеза1е, 1); 
1Е ( (АмВеза1е & 0х20) == 0х00) ргеак; 
// закончилось время ожидания 
1Е ( 1Тёлема1Е < 1) гебага МУ ЕВВОВ _ТТМЕ; 
} 
// получаем второй байт состояния 
ТпРогЕ ( 0х60, &ЧмВези1%, 1); 
// сохраняем значение второго байта в переменной 
Ь3амз_2 = (ВУТЕ) амВези1Е; 
// ожидаем данные 
1Тема1е = 50000; 
// проверяем, успешно ли передана команда 
\11е ( -- 1Тллемаце > 0) 
{ 
// читаем состояние порта 
1пРохЕ ( 0х64, вдмкезащ, 1); 
1Е ( (АмВеза1е & 0х20) == 0х00) Бгеак; 
// закончилось время ожидания 
1Е ( 1Тшейа1е < 1) гебагп МУ_ЕВВОВ_ТТМЕ; 
} 
// получаем третий байт состояния 
1пРогЕ ( 0х60, &@мкезит, 1); 
// сохраняем значение третьего байта в переменной 
Ь56аиз 3 = (ВУТЕ) @мВезчи1е; 


2.3.14. Команда $е! Незо/иНоп (ЕЗВ) 


Данная команда предназначена для установки разрешения мыши Р5/2. 
Команда является двухбайтовой. Вначале в регистр данных записывается 
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код команды Е8т. Мышь подтверждает получение команды записью в ре- 
гистр данных кода -гАв. После этого в регистр данных записывается второй 
байт команды, который содержит новое значение разрешения. Мышь вто- 
рично подтверждает получение, записав в регистр данных код кАв. Возмож- 
ные значения кода разрешения перечислены в табл. 2.7. 


2.3.15. Команда $еЁ $са/тод 2:1 (Е7Н) 


Команда предназначена для установки режима масштабирования 2:1, по- 
зволяющего улучшить чувствительность мыши за счет нелинейного пере- 
счета датчиков движения (см. табл. 2.3). Мышь подтверждает получение 
команды записью в регистр данных кода ЕАН. 


2.3.16. Команда $еЁ $са!под 1:1 (ЕбЁ) 


Эта команда позволяет восстановить режим масштабирования, используе- 
мый по умолчанию и равный 1:1. Мышь подтверждает получение команды 
записью в регистр данных кода ЕЛЬ. 

* * * 


На этом можно завершить описание команд управления мышью Р5/2. Хочу 
только заметить, что в своих программах желательно проверять различные 
ошибки (см. табл. 2.13) завершения, а не только код гАВ. Это позволит точ- 
нее определить проблему сбоя и принять соответствующие меры. 


Теперь рассмотрим, какие возможности для поддержки устройства мыши 
предлагает нам фирма Мисгозой. 


2.4. Использование \М/т32 АР] 


Набор возможностей, предоставляемый этим программным интерфейсом, 
небогат, но позволяет решить основные вопросы использования мыши в 
операционных системах Упдо\з. Общие темы, которые мы рассмотрим 
злесь, можно свести к короткому списку: 


1. Настройка мыши. 


2. Работа с курсором. 


2.4.1. Настройка мыши 


Удобство работы с мышью в программе часто служит определяющим фак- 
тором, по которому судят о качестве программного обеспечения. Особенно 
это касается пользователей, использующих левую руку в качестве основной, 
проще говоря, левшей. Мало кто из разработчиков программного обеспече- 
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ния думает об этом. Конечно, в настройках УЙп4о\$ есть возможность по- 
менять местами левую и правую кнопки мыши, но у рядового пользователя 
в связи с этим возникают проблемы. Во-первых, нужно хорошо знать сис- 
тему, чтобы найти нужные настройки. Во-вторых, такую операцию прихо- 
дится выполнять достаточно часто, что отвлекает от основной работы на 
компьютере. Было бы гораздо проще, если бы каждый разработчик про- 
граммного обеспечения думал об этом заранее и добавлял в свою программу 
возможность менять значения левой и правой кнопок мыши. Это добавит 
программе только плюс. 


Программно решить эту задачу в \УИпдо\5 не сложно. Существует два спо- 
соба, о которых я хотел бы рассказать. Прежде всего, замечу, что оба спосо- 
ба изменяют глобальные настройки системы, поэтому следует восстанавли- 
вать стандартные значения перед закрытием своей программы. Первый спо- 
соб` состоит из вызова функции ЗмарМоизеВаехоп. Данная функция имеет 
всего один аргумент (тип вост), который определяет направление операции. 
Чтобы поменять местами левую и правую кнопки мыши, присвойте аргу- 
менту значение твоЕ. Для восстановления значения по умолчанию вызовите 
функцию со значением ГАЪЗЕ. Функция $марМоизевиесоп возвратит нулевое 
значение, если до этого назначение кнопок не менялось, и единицу в 0б- 
ратном случае. Второй способ состоит в использовании универсальной 
функции зузкемрагате<ехгз типо с установленной опцией $РТ_ЗЕТМООЗЕВОТТОМ$ИАР. 


Для лучшего понимания просмотрите примеры, представленные в листин- 
гах 2.2] и 2.22. 





Листинг 2.21. Использование функции $нарМоцзеВае оп 
// напишем свою функцию для смены кнопок мыши 
рооЪт БеЕСТоВ1айЕ ( Боо1 БВ} 
{ 
1Ё ( ЗмарМопзеВиЕ®оп ( БВ} != 0) 
// состояние кнопок уже изменено 
гесагп Га15е; 
гебагп 6гхое; 
} 
// используем нашу функцию в коде 
// 
уо1Аа МочзеВаЕ®опз () 
{ 
1Е ( 'ЪеЕсТовзареЕ ( 6хае})} 
// если состояние кнопок уже менялось, восстановив по умолчанию 
ТеЕсТор1аНе ( ЁЕа15е); 
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Для того чтобы узнать текущее состояние кнопок, можно воспользоваться 
функцией сеезузкетМеет1сз с аргументом зм ЗМАРВОТТОМ. Если значения ле- 
вой и правой кнопок были изменены, функция возвратит ненулевое значе- 
ние, иначе результат будет равен нулю. 





‚ Листинг 2.22. Использование функции 5узеемРагатекег:ТпЕо 





// напишем свою функцию для смены кнопок мыши 
0501 БеЕЕТов1айе ( рооЪ БВ) 
{ 
ЗузсевРагатетегзТпЕо ( 5РТ_ ЗЕТМООЗЕВОТТОМ$ МАР, (ПТМТ).ЬЬВ, МОБ, 
ЗРТЕ ОРРАТЕТМТЕТЬЕ); 


Вызов Функции ЗузкетРагамекег1нРо записывает в системный файл 
УМ. 1М1 значение в виде цифры (например, "1"). Однако при последующей 
загрузке \п4о\ параметры мыши могут остаться прежними, независимо 
от ваших действий. Происходит это потому, что панель управления тоже 
записывает в указанный системный файл информацию о состоянии кнопок 
мыши, но она использует буквенное обозначение (например, вместо "1" 
слово "Уе5"). Приоритет всегда будет отдан буквенному значению ("Уе5" или 
"М о"), поэтому, чтобы избежать таких неожиданностей, следует использо- 
вать функцию змарМоизеВа& оп. 


Кроме изменения состояния левой и правой кнопок мыши, можно про- 
граммно менять время реакции системы на двойной щелчок. Для этого ис- 
пользуется функция зекроир1еС11скТ1ие, имеющая всего один аргумент, ко- 
торый задает максимальное значение времени ожидания (в миллисекундах) 
между первым и вторым щелчком мыши. Значение по умолчанию, исполь- 
зуемое в \п40\5, равно 500 мс. Для установки времени по умолчанию дос- 
таточно вызвать функцию зеебозЪ1ес11скТате с нулевым значением аргу- 
мента. В случае ошибки функция возвращает 0, и для получения детального 
описания возникшей ситуации следует вызвать сеетаз(Етгог. 


Кроме зеероць1еС11скТ1ще, существует функция секроцЬ1еСс11сКТзще, которая 
позволяет узнать текущее значение времени реакции на двойной щелчок. 
Она не имеет аргументов и возвращает тип отмт, характеризующий время 
реакции системы на двойной щелчок мыши (в миллисекундах). В листин- 
ге 2.23 приведен пример работы с функциями Зекроир1ес11скте и 
беЕрбоир1еС11скТ1ще. 








Листинг 2.23. Использование функций 5еРоч51еС11скТаме 
: И Се роцЬ1еС11сКкТа те 


// напишем собственную функцию установки времени двойного щелчка мыши 
6001 Зе 0Ь1С11скТиае ( ипз1дпея 11 оТлие) 
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ип$1апея 116 иСоггхепеТще = 0; 
// получаем текущее значение 
иСиггепеТ1ме = беероср1еС11скТ1ме (); 
// если оно совпадает с устанавливаемым, выходим из функции 
1Е ( оТше == аСагтепЕТ1те) 
гебаги Ёа1зе; 
// если нет, устанавливаем новое значение 
1Е ( Зеболю1еС11скТиае ( оТае) == 0) 
{ 
// произошла ошибка, вызываем СеёТтаз&Егког, если нужно 
тебагп Еа15е; 
} 
тебоги &гие; 


} 


Как видно из примеров, работа с этими функциями не представляет ника- 
ких проблем. Хочу только заметить, что изменение времени реакции между 
двумя щелчками мышью действует для всей операционной системы. 


Кроме описанного способа, существует еще один, использующий универ- 
сальную функцию ЗузкеюРахащекехзТпРо. Для установки текущего значения 
времени применяется параметр $РТ_ЗЕТРООВГЕСЬТСКТТМЕ. 


Существует еще один параметр, которым можно управлять программно, — 
скорость движения указателя мыши по экрану. Для реализации этой воз- 
можности также применяется функция зузеетРатащесет1пРо. Получить те- 
кущее значение скорости можно, вызвав ее с параметром 3РТ_СЕТМО0ЗЕЗРЕЕР, 
а установить новое значение — с параметром зРТ_ЗЕТМООЗЕЗРЕЕР. Диапазон 
возможных значений лежит в пределах от 1 до 20. По умолчанию использу- 
ется значение 10. Пример функции, изменяющей скорость движения указа- 
теля, представлен в листинге 2.24. 


: Листинг 2.24. Установка скорости движения указателя мыши 





// напишем свою функцию для управления скоростью движения указателя мыши 
10 ЗрееаМочлзе ( 1пе 15рееа, Боо1 ЪЕ1ач) 

{ 

3Е ( РЕ1аа) // установить скорость 
{ 
1Е ( ( 15реея > 0) && ( 15рееа < 21)) // проверяем диапазон 
{ 
ЗузеетРахамееетзТюЁо ( ЗРТ ЗЕТМООЗЕЗРЕЕР, 0, (РУОТР) 15рееа, 
ЗРТЕ _ЗЕМОСНАМСЕ | 5ЗРТЕ ОРРАТЕТМТЕТЬЕ); 
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е15е // получаем текущее значение скорости 
{ 
116 1Саггеребрееа = 10; // значение по умолчанию 
ЗузкетРагатекегзТпо ( ЗРТ СЕТМОЧЗЕЗРЕЕО, 0, &1Соггепе5рееа, 0); 
тееагп 1Соггепе5рееа; | 
} 
тебогп 0; 


} 


Представленная читателям функция зрееЧМоозе имеет два аргумента. Пер- 
вый аргумент передает значение скорости, а второй указывает на тип вы- 
полняемой операции (установка или получение текущего значения скоро- 
сти). 


Последняя возможность управления мышью, которую я хотел бы рассмот- 
реть, представляет собой блокировку всех событий мыши. Функция называ- 
ется В1осктприе и позволяет блокировать не только мышь, но и клавиатуру. 
Единственный аргумент функции, установленный в ТВОЕ, блокирует мышь и 
клавиатуру. В случае ошибки функция возвращает 0, и для получения де- 
тального описания возникшей ситуации следует вызвать беТаз%Еггог. При- 
мер работы данной функции приведен в листинге 2.25. 


‚ Листинг 2.25. Блокировка мыши и клавиатуры Е 





// обязательно включите файл Мпар1е.В 
Нос1оае <М1пар1е.6> 
// пишем функцию блокировки 
роо1 БосКМоцзе ( роо1 АсЕ1оп) 
{ 
1Е ( ВЪоскКТарае ( Асё1оп) == 0) 
{ 
// ошибка выполнения 
тебогп Еа15е; 
} 
гесагп Сгоае; 


} 


Прежде чем использовать функцию В1осктпрае, следует учесть несколько 
важных факторов: 


1. Функция полностью блокирует мышь и клавиатуру, поэтому в программе 
следует задавать время по таймеру, после которого устройства будут раз- 
блокированы. 


2. Восстановить доступ к устройствам можно с помошью перезагрузки 
компьютера или нажав комбинацию клавиш <С]>+<АК>+<Ое]>. 
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Из сказанного выше можно сделать основной вывод: разработчик програм- 
мы, использующий функцию в1оскТпрае, должен позаботиться о полном 
восстановлении работы мыши и клавиатуры. В процессе блокировки про- 
граммист может применять функцию зепатпрое, имитирующую нажатия 
кнопок мыши и клавиатуры. 


И последняя возможность, о которой хотелось бы рассказать, — это полу- 
чение краткой информации о мыши. Чтобы определить, установлена ли в 
системе мышь, можно вызвать функцию сесбузкетметг1св со значением 
ЗМ МООЗЕРВЕЗЕМТ. Если мышь установлена, функция возвратит ненулевое 
значение, иначе будет возвращен 0. В листинге 2.26 приведен пример ис- 
пользования этой функции. 





Листинг 2.26. Проверка наличия в системе устройства мыши 





// пишем функцию для проверки подключения мыши 
Роо1 Т3Мочзе () 
{ 
1Е ( беббузсетМест1сз ( 5М МООЗЕРВЕЗЕМТ)) 
гебогп 6гое; // мышь установлена 
гефогп ЕГа15е; 


} 


Кроме определения наличия в системе мыши, можно получить данные 
о количестве кнопок и наличии колеса прокрутки. Для получения количест- 
ва кнопок мыши нужно вызвать функцию сеезузтешМеск1сз со значени- 
ем 3М СМООЗЕВОТТОМ$, а для проверки наличия колесика — со значением 
ЗМ МООЗЕМНЕЕТЪРВЕЗЕМТ. В первом случае функция вернет количество кнопок 
или значение 0, если мышь отсутствует. Во втором случае функция возвра- 
тит ненулевое значение, если колесо прокрутки имеется. В листинге 2.27 
показано, как это делается. 


: Листинг 2.27. Получение информации о числе кнопок и наличии 
: колеса прокрутки 





// напишем функцию, определяющую число кнопок мыши 
116 сбеМочзеВи®®опз$ () 
{ 

1106 1№м = 0; 

{Мом = беббузвенМеет1с: (5М СМООЗЕВОТТОМ$); 

1Е ( 1№м) 

тебахп П\ли; // количество кнопок 

гебогп 1№м; // мышь отсутствует 


} 
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// напишем функцию для определения колеса прокрутки 

роо1 Т5МопцзейРее1 () 

{ 

1Е ( себбузЕенМеет1с$ ( ЗМ МООЗЕМНЕЕГРВЕЗЕМТ)) 
тебогп гие; ‘// мышь установлена 

гебогп Еа15е; 


} 


2.4.2. Работа с курсором 


В У!пао\$ курсор мыши представляет собой черно-белый или цветной зна- 
чок и может быть статическим или динамическим (так называемый "живой" 
указатель). В системе всегда имеется стандартный набор курсоров для ис- 
пользования в различных ситуациях. Этот набор называется системным и 
может применяться в программе по умолчанию. Мы рассмотрим наиболее 
часто востребованную возможность работы с курсорами для создания визу- 
ального ожидания завершения какой-либо операции в программе. Те чита- 
тели, кто знаком с классом Сиа1ЕСигзог Из библиотеки МЕС, сразу поймут, 
о чем идет речь. В каждой программе так или иначе встречаются функции, 
требующие определенного времени для завершения. Чтобы пользователь 
видел, что программа не "зависла", а продолжает выполняться, необходимо 
как-то сообщить ему это. Обычно текущий курсор (как правило, в виде 
стрелки) на время выполнения операции заменяется другим (как правило, в 
виде песочных часов). Для реализации такой возможности мы создадим 
полноценный класс, который можно будет легко использовать в различных 

` программах. Назовем наш класс сиа1ЕМоизе. Файл объявлений (С\/аиМочзе.П) 
представлен в листинге 2.28, а файл реализации (С\У/айМоцзе.срр) — в лис- 
тинге 2.29. 





Листинг 2.28. Файл СМ/Ма{Моцзе.В 


с1аз$ СМа1ЕМочзе 
{ 


руБ11с: 
СИа1ЕМоцзе (); // конструктор по умолчанию 
—СМа1ЕМоцзе () { } // пустой деструктор 
// общедоступные функции 
Уо1а Ма1* (); // функция отображает курсор ожидания 
У01А Везкоге (); // функция восстанавливает прежний курсор 
рглхафе: | 


Боо1Т Ю5еаеоз; // хранит текущее состояние курсора 
у019 $еМа1е ( Ьоо1 ЮМа1{); // установка курсора ожидания 
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#10с104е " СМа1ЕМочзе. в" 

// прямо в конструкторе изменяем вид курсора 
СМа1ЕМоцзе :: СМа1ЕМоцзе () 

{ 


Ю5еаба$ = ЁЕа15е; // инициализация 
Зе Ма1е ( Егае); // устанавливаем курсор ожидания 
} 
// функция восстанавливает прежний вид курсора 
%014 СМа1ЕМоо5е :: Кезкоге () 
{ 
ЗеЕМа1е ( ЁЕа15е); 
} 
// функция устанавливает курсор ожидания 
у01А СИа1ЕМоцзе :: Ма1е () 
{ 
// проверяем, не установлен ли курсор ожидания ранее 
1Е ( ЮЗЕаба$) гебоагп; 
// если нет, устанавливаем 
Зе Ма1е ( $гае); 
} 
// функция обработки курсора 
%У01Я Сма1ЕМоцзе :: ЗеЕМа1е (Боо1 БМа1®) 
{ 
// дескриптор для нового курсора 
НСОВЗОВ ВСоагзог = МОШ;; 
// дескриптор для хранения старого курсора 
5фаф1с НСОВЗОВ В5®аг1КСагзог = МОШ; 
// проверяем тип операции 
1Е ( БМа12) // показать курсор ожидания 
{ 
ВСигзог = ГоааСагзог (МОШ., ТОС МАТТ); 
Н$фаг1КСогзог = ЗееСогзог ( ВСог5ог); 
Р5фаеа$ = ©гое; 
} 
е15е // восстановить прежний курсор мыши 
{ 
Зе Сигзог ( р5%аг1КСог$ог); 
О5фабаз = Еа15$е; 
} 
} // конец функции 


Внимательно изучив код нашего класса, вы увидите, что вся основная рабо- 
та выполняется в функции зеИа1+. Для загрузки курсора ожидания мы вы- 
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полнили два основных действия: загрузили стандартный курсор ожидания 
(тос иАтТ) и заменили им текущий курсор. Загрузка курсора выполнена с 
помощью библиотечной функции ГоааСагзох. Данная функция имеет два 
параметра: первый указывает на дескринтор нашей программы (тип 
НТМУТАМСЕ), а второй определяет тип курсора для мыши. Поскольку мы ис- 
пользуем стандартный курсор, первый аргумент можно установить в мо1л. 
Второму аргументу присваиваем одно из значений, перечисленных в 
табл. 2.16. 


Таблица 2.16, Возможные значения для системных курсоров 


Константа Описание 

ТОС МАТТ Значок "Песочные часы" 

ТОС_АВВОИ Значок стандартной стрелки 

ТОС_СВО5$ Значок перекрестья 

ТОС НЕГР Значок в виде вопросительного знака со стрелкой 
ТОС _НАМР Значок в виде руки 

ТРОС _ОРАВВОЙ Значок в виде вертикальной стрелки 

ТС _ЗТ2ЕАШ, Значок изменения размеров 





После успешного завершения функция ГоааСогзог вернет дескриптор загру- 
женного курсора (тип нсокзов). Для вывода нового курсора на экран необ- 
ходимо вызвать функцию зеЕСигзог. Она имеет один аргумент, куда зано- 
сится дескриптор необходимого курсора. В случае успешного завершения 
функция вернет дескриптор старого курсора, который мы сохраняем в ста- 
тической переменной для последующего восстановления. Вот и все премуд- 
рости. 


Существует возможность программно скрыть курсор с экрана. Для этого 
применяется функция звомСигзог. Функция имеет всего один аргумент. Ес- 
ли нужно скрыть курсор, вызовите эту функцию с аргументом ЕАтзЕ. Хит- 
рость состоит в том, что функция при каждом вызове увеличивает (тВоЕ) 
или уменьшает (кАТЗЕ) внутренний системный счетчик. Когда значение 
счетчика больше или равно 0, курсор видим на экране. Если мышь присут- 
ствует, начальное значение счетчика равно 0, иначе — 1. Исходя из выше- 
сказанного, необходимо следить, чтобы каждый вызов $помСигзог Имел по- 
вторный вызов этой функции в программе. После выполнения функция 
возвращает текущее значение счетчика. Примеры работы с данной функци- 
ей я приводить не буду, поскольку она достаточно проста в использовании. 


На этом мне бы хотелось завершить тему программирования мыши и пе- 
рейти к не менее важному устройству — клавиатуре. 


ГЛАВА З 


Клавиатура 


Клавиатура является одним из самых старых, но не менее актуальных и се- 
годня устройств. Без нее трудно представить полноценный компьютер. Не- 
смотря на бурное развитие программных средств голосового управления 
компьютером, клавиатура остается наиболее надежным и совершенным 
средством управления программным обеспечением. Важность ее трудно пе- 
реоценить, что позволяет мне утверждать о необходимости изучения раз- 
личных способов программирования этого привычного для каждого пользо- 
вателя устройства. 


Мы рассмотрим три основных способа программирования клавиатуры: 
1. Поддержка клавиатуры посредством функций В1О$. 

2. Работа с контроллером клавиатуры напрямую через порты. 

3. Программирование клавиатуры в \!132 АР1. 


Каждый программист может выбрать один из трех вариантов, в зависимости 
от поставленной задачи, но, прежде чем мы приступим к рассмотрению 
этих способов, позвольте мне немного рассказать о самом устройстве кла- 
виатуры. 


3.1. Общие сведения 


На сегодняшний день существует два основных типа клавиатуры: АТ и 
Р5/2. Первый тип уже морально устарел и практически полностью вытеснен 
современным стандартом Р5/2. Кроме основных тинов клавиатур существу- 
ют и другие, реже встречающиеся устройства: Ч$В и инфракрасные. Для 
поддержки клавиатуры используется интегрированный в системный чип 
контроллер (например, Пие! 8042 или М\А 8242), одновременно поддержи- 
вающий и мышь Р5/2. 
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По количеству клавиш клавиатуры можно разделить на несколько типов: 


О клавиатуры ХТ с 83 клавишами. Появились в 1981 году. Использовали 
5-штырьковый разъем О1№. Передача данных была организована по од- 
нонаправленному последовательному протоколу. На данный момент 
полностью устарели; 


С клавиатуры АТ с 84—101 клавишами. Появились в 1984 году. Используют 
5-штырьковый разъем ОПМ. Передача данных организована по двуна- 
правленному последовательному протоколу; 


О клавиатуры Р$/2 с 84—101 клавишами. Появились в 1987 году. Исполь- 
зуют 5-штырьковый разъем ти!-ОПМ. Передача данных организована по 
двунаправленному последовательному протоколу; 


С современные клавиатуры Р5$/2 с 101—104 (или более) клавишами. Ис- 
пользуют 6-штырьковый разъем ти!-ОИМ. Передача данных организова- 
на по двунаправленному последовательному поотоколу. 


Как правило, все клавиатуры состоят из набора клавиш и встроенного мик- 
ропроцессора. Главная задача микропроцессора состоит в передаче скан- 
кода нажатой (отпущенной) клавиши (комбинации клавиш) на компьютер и 
обработку управляющих команд от него. Для ускорения работы имеется 
встроенный буфер (обычно 16 байт), позволяющий хранить данные обмена 
между клавиатурой и компьютером. Для управления клавиатурой разработан 
набор специальных управляющих команд. Следует иметь в виду, что неко- 
торые современные РЗ/2 клавиатуры могут не поддерживать отдельные 
команды. Команды управления будут рассмотрены далее в этой главе. Обмен 
данными между клавиатурой и компьютером (контроллером клавиатуры, 
расположенном на материнской плате) работает по протоколу, разработан- 
ному фирмой 1ВМ. Встроенный в клавиатуру микропроцессор сканирует 
шину в ожидании нажатия (отпускания) любой клавиши. Если произошло 
нажатие (отпускание или удержание) клавиши, вырабатывается определен- 
ный скан-код (набор скан-кодов), позволяющий компьютеру определить 
текущее состояние клавиатуры. Каждая клавиша имеет свой уникальный 
скан-код. Описание некоторых скан-кодов клавиш приводятся далее в 
табл. 3.2 и 3.3. Каждый переданный компьютеру скан-код (числовое значе- 
ние) обрабатывается и преобразовывается в код АЗСИ, который и применя- 
ется для передачи смыслового содержания нажатой клавиши. Скан-код для 
стандартной клавиатуры (84 клавиши) имеет размер 1 байт, а для расши- 
ренной — от 2 до 4 байтов. Чтобы отличить расширенный скан-код от 
обычного, в качестве первого байта всегда выступает значение ЕбЪ (напри- 
мер, код левой клавиши <АШ> равен з8р, а правой — ЕбВ, з8В). Кроме уни- 
кального кода нажатия, каждая клавиша имеет свой код отпускания. Как 
правило, этот код состоит из двух байт, первый из которых всегда равен кон. 
На расширенных клавиатурах коды отпускания имеют размер три байта, где 
первые два байта всегда равны ЕОЪ, ков, а третий байт является последним 
байтом скан-кода нажатия. 
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Существует три основных набора скан-колов: стандартный ХТ (поддержива- 
ется некоторыми современными клавиатурами), набор по умолчанию (под- 
держивается всеми современными клавиатурами) и набор кодов Р5$/2 (не- 
обязательный и может не поддерживаться современными клавиатурами). 
Далее в табл. 3.17 приводится описание второго набора скан-кодов. В лю- 
бом случае рекомендую читателям скачать в Интернете и распечатать для 
себя все скан-коды, поддерживаемые современными клавиатурами (особен- 
но мультимедийными). 


3.2. Использование функций ВО $ 


Данный способ базируется на стандартном наборе функций В1О$, исполь- 
зующих прерывание 1п= 16. Список всех функций представлен в табл. 3.1. 
Современные системы поддерживают следующие типы клавиатур: 84-кла- 
вишные, 102-клавишные и 122-клавишные. Каждая клавиша имеет свой 
скан-код, который обрабатывается В1О$ при нажатии или отпускании. Для 
поддержки 84-клавишных устройств используются только функции 00в, о1н 
и 025. Функции 10%, 11н и 12ь поддерживают 83-клавишные и 102-кла- 
вишные устройства. Функции 205, 215 и 22. поддерживают все типы кла- 
виатур. 


Таблица 3.1. Список функций ВО$ 


ии Описание 
00в Получить скан-код й АЗС!-код клавиши 
018 Проверить, была ли нажата клавиша 
028 Получить состояние специальных клавиш 
03в Управление режимом автоповтора и значением задержки 
о4в Использовать звуковой сигнал 
05. Сохранить код клавиши в буфере клавиатуры 
ов Получить информацию о.возможностях клавиатуры 
бАВ Получить идентификатор клавиатуры 
108 Прочитать код клавиши для расширенной клавиатуры 
11 Проверить, была ли нажата клавиша на расширенной клавиатуре 
128 Получить состояние специальных клавиш на расширенной клавиатуре 
208 Получить скан-код и АЗС!-код клавиши 122-клавишной клавиатуры 


21в Проверить, была ли нажата клавиша на 122-клавишной клавиатуре 
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Таблица 3.1 (окончание) 


Код 
Описание 
функции 
228 Получить состояние специальных клавиш 122-клавишной клавиатуры 
РЕВ Добавить код клавиши в конец буфера клавиатуры 


Рассмотрим подробнее каждую функцию ВГО$. 


3.2.1. Функция 00В 


Функция позволяет получить скан-код и А$СП-код нажатой клавиши. 
С помощью данной функции нельзя получить код дополнительных клавиш 
на расширенной клавиатуре. Для этого следует использовать функцию 10%. 
Функция считывает символ из буфера клавиатуры, а затем очищает буфер. 
При получении кодов от управляющих клавиш (например, <Пробел>) в ре- 
гистр Ат, будет записан АЗСП-код, равный 0. 


Использование: 
1. В регистр Ан следует поместить код функции оон. 


2. Вызвать прерывание 114 165. 


Выход: 

После выполнения функции в регистр Ан будет помещен скан-код ВОЗ 
символа, а в регистр АЪ — АЗСИ-код символа. Стандартный набор значений 
скан-кодов для клавиатуры представлен в табл. 3.2, а расширенный — 
в табл. 3.3. Кроме того, в табл. 3.4 представлены коды управляющих симво- 
лов АЗСИ. 


Таблица 3.2, Скан-коды клавиатуры 











Клавиша Код Клавиша Код 










Зрасе 


Зи# 048 Сарз Носк ЗАВ 
4и$ 058 Е1 ЗВВ 
5и % обв Е2 Зсв 
би^ 07в ЕЗ ЗОВ 


Е4 
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Таблица 3.2 (окончание) 





8и* 098 Е5 ЗЕВ 
Эи( ОАВ Е6 40 
Оби} овв Е7 418 
-и_ ось ЕВ 42 
=и+ овь Е9 аЗв 
Васк Зрасе ОВ | ‘ил Е10 44в 
Таь оп | ейзьм | Ми оск 458 
(©) 108 \и| | Зсго! |-оск 468 
М И 2 Ноте 478 
Е 12 Хх Аггоми Др 48 
В 138 С Раде Ур 498 
Т 14 \ —_ дАВ 
ый 158 В Агом Гей 4ВВ 
9 168 М 5 асв 
| 178 М Атом Вам арВ 
[®) 182 + ЕВ 
Р 191 Епа 4ЕВ 
[м{ в | 1? | ? 508 
]и} ВВ Вов ЗВ Раде Эомп 51В 
пзей 52в ОБеве 


Таблица 3.3. Коды для расширенной клавиатуры 











Клавиша Код Клавиша Код Клавиша Код Клавиша Код 


















АН+Е1 
АН + Е2 
АК + ЕЗ 
АН + Е4 
АН + Е5 


ЗН + Е1 
ЗНИ + Е? 
ЗН + РЗ 
НИ + 24 
ЗНИ + РБ. 


СШ +Е1 
СШ+ЕР2 5 
СШ+ЕЗ 60 
СШ+Е4 61 
Ст + Е5 


Е2 Св 





ЕЗ Зов 





Е4 ‚ ЗЕВ 








84 

Клавиша Код Клавиша 
Е6 408 АН+Еб 
Р7 418 АК+РЕ7 
ЕВ 428 АК + 28 
Е9 438 АН +Р9 
Е10 448 АК + 210 
Е11 858 АК+Р11 
[12 868 АН+Е12 
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Таблица 3.3 (окончание) 


Код Клавиша Код Клавиша Код 
ЗН + Рб С + Еб 63в 
ЗН + Р7 СИ +РЕ7 64в 
ЗНИ + 28 С + Е8 658 
ЗН + РЭ С + 9 66 
ЗН + 210 С +210 67ь 
ЗН + Е11 СИ +211 895 
ЗН + 212 СШ +712 ЗАВ 


Таблица 3.4. Управляющие символы АЗСИ 


Код Название 


0 МИ 
1 ЗОН 
2 $тх 
3 ЕТХ 
4 ЕОТ 
5 ЕМОа 
6 АСК 
7 ВЕЕ 
8 В$ 
9 НТ 
ОА ГЕ 
ов УТ 
ос ЕЕ 
00 СВ 
0Е $0 
ОЕ Я 
10 ОЕ 
11 0С1 
12 062 


Описание 


Конец строки или пустой символ 
Начало заголовка 

Начало текста. 

Конец текста 

Конец передачи 
Подтверждающий запрос 
Подтверждение 

Звуковой сигнал 

Возврат на одну позицию влево 
Горизонтальная табуляция 
Перевод строки 

Вертикальная табуляция 
Переход на новую страницу 
Возврат каретки 

Нижний регистр 

Верхний регистр 

Освободить канал связи 
Управление устройством 1 


Управление устройством 2 
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Таблица 3.4 (окончание) 


Код Название Описание 


13 0С3 Управление устройством 3 
14 0С4 Управление устройством 4 
15 МАК Подтверждение ошибки передачи 
16 ЗУМ Синхронизация 

17 ЕТВ Конец передаваемого блока 
18 САМ Отмена 

19 ЕМ Конец носителя 

1А ИВ Замена 

1В Е$ЗС Выход или переход 

1С Е$ Разделитель файлов 

10 а$ Разделитель групп 

1Е В$ Разделитель записей 

1Е $ Разделитель полей 

20 ЭР Пробел 

7Е ОЕЁ Удаление 


Пример работы с функцией 00ъ, показанный в листинге 3.1, позволяет оп- 
ределить, была ли нажата управляющая клавиша. 








: Листинг 3.1. Использование функции 005 


@гереат: 

поу АН, 0 ; код функции 008 

116 166 ; вызываем прерывание 

ог АГ, АБ ; проверяем регистр АЦ 

312 @гереаЕ ; если нажата не управляющая клавиша, повторяем 
поу АГ, АН ; перепишем управляющий код в АЁ 


3.2.2. Функция 018 


Данная функция позволяет проверить нажатие клавиши на клавиатуре. Если 
клавиша была нажата, функция запишет в соответствующие регистры скан- 
код и АЗСП-код клавиши. Буфер клавиатуры не очищается. 
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Использование: 
1. В регистр дн следует поместить код функции ов. 


2. Вызвать прерывание 10% 168. 


Выход: 


После выполнения функции в регистр Ан будет помещен скан-код В1О$ 
символа, а в регистр д. — АЗСП-код символа. Кроме того, если нажатия 
клавиши не было, флаг 2 будет установлен в |. Если клавиша была нажата, 
флаг 7Е будет сброшен. Приведу простой пример, в котором проверяется 
нажатие клавиши <Е$с> (листинг. 3.2). 





: Листинг 3.2. Использование функции 015 


@гереаф: 

оу АН, 1 ; код функции 01. 

116 168 ; вызываем прерывание 

32 @тереафе ; нажатия клавиши не было, повторяем опрос 
оу АН, 0 ; клавиша была нажата 

1106 166 ; читаем код клавиши 


спр АБ, 27 ; сравниваем полученный АЗСТТ-код с кодом ЕЗС (1ВВ) 
те @гереа® ; если код не соответствует клавише ЕС, повтор 


3.2.3. Функция 028 


Эта функция позволяет получить состояние специальных клавиш на кла- 
виатуре: <ЗШИ>, <Си1>, <АШ, <Мит ШосК>, <5сгоЙ КосК>, <Сарз ГосК> и 
<[т5ец>. 


Использование: 
1. В регистр Ан следует поместить код функции 025. 
2. Вызвать прерывание 106 161. 


Выход: 


После выполнения функции регистр Аь будет хранить байт состояния спе- 
циальных клавиш. Формат этого байта представлен в табл. 3.5. 


Таблица 3.5. Формат байта состояния клавиатуры 





Бит Описание 





0 Правая клавиша ЗН (1 — нажата, 0 — не нажата} 
1 Левая клавиша ЗН (1 — нажата, 0 — не нажата) 


2 Любая клавиша СШ (1 — нажата, 0 — не нажата} 
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Таблица 3.5 (окончание) 


Бит Описание 


Любая клавиша АК (1 — нажата, 0 — не нажата} 
Переключатель Зсго! [оск (1 — включен, 0 — выключен) 
Переключатель Мит [оск (1 — включен, 0 — выключен) 


Переключатель Сарз [оск (1 — включен, 0 — выключен) 


чояьт 2 


Переключатель 1пзем (1 — включен, 0 — выключен) 


Простой пример, определяющий нажатие клавиши <АШ>, представлен в 
листинге 3.3. 








Листинг 3.3. Использование функции 025 


бесАТЕ 

поу АН, 2 ; код функции 026 

11 168 ; вызываем прерывание 

апа А], 8 ; проверяем нужный бит 

312 Сева ; ни одна клавиша А1® не нажата, повтор 


3.2.4. Функция ОЗВ 


Функция позволяет установить режим автоповтора и время задержки. 
Использование: 

1. В регистр Ан следует поместить код функции озь. 

2. В регистр Ат надо записать тип операции: 


® 001 — значения по умолчанию (только для некоторых клавиатур Р5/2) 
для автоповтора и времени задержки; 


» 045 — отключение автоповтора (только для некоторых клавиатур 
Р5/2); 


» 051 — установка количества повторов и времени задержки для всех 
стандартных клавиатур; 


» 061 — получение текущего значения частоты ‘повторений и времени 
задержки (поддерживается некоторыми новыми клавиатурами Р5$/2). 


3. В регистр вн необходимо записать значение кода задержки (табл. 3.6). 


4. В регистр вь необходимо записать значение кода частоты повторений 
(табл. 3.7). 


5. Вызвать прерывание 1пе 161. 
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Таблица 3.6. Код задержки 


Значение кода — Время задержки, мс 


ов 250 
018 500 
028 750 
озн 1000 


Таблица 3.7. Код частоты повторений 





Значение Частота, Значение Частота, 
кода символов/С кода символов/С 
оон 30,0 101 7,5 
ОВ 26,7 11в 6,7 
02В 24,0 128 6,0 
зв 21,8 13В 5,5 
о4в 20,0 14 5,0 
05. 18,5 158 4,6 
068 17,1 166 4,3 
07ь 16,0 178 4,0 
08в 15,0. 18В 3,7 
оэн 13,2 19 3,3 
ОАВ 12,0 1АП 3,0 
овь 10,9 1вв 2,7 
осв 10,0 1сВ 2,5 
орв 9,2 108 2,3 
ОЕВ 8,6 ЗЕВ 2,1 
ЕВ 8,0 ЕВ 2,0 
Выход: 


После выполнения функции регистр вт, будет хранить значение частоты по- 
втора, а регистр вн — время задержки. Выходные параметры истинны толь- 
ко для типа операции с кодом 06ъ. 
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Рассмотрим пример работы с функцией о3ь (листинг 3.4), в котором попы- 
таемся установить время задержки 750 мс и частоту повтора 20 символов 
в секунду. 





Листинг 3.4. Использование функции 035 


поу АН, 3 ; код функции 03ЗВ 

поу АБ, 5 } тип операции 

поу ВН, 2 ; время задержки 750 мс 

поу ВЫ, 4 ; частота повтора 20 символов/с 
116 166 ; вызываем прерывание 


3.2.5. Функция 041 


Эта функция позволяет управлять установкой звукового сигнала для нажа- 
тия клавиш. При активизации сигнала каждое нажатие будет сопровождать- 
ся характерным щелчком. 


Использование: 
1. В регистр Ан следует поместить код функции 045. 


2. В регистр Ат необходимо занести управляющий код (1 — включить зву- 
ковой сигнал, 0 — отключить звуковой сигнал). 


3. Вызвать прерывание 1пе 164. 


Функция не имеет специальных выходных параметров. Пример кода, ис- 
пользующий данную функцию, приведен в листинге 3.5. 


Листинг 3.5. Использование функции 04ь 


поу АН, 4 ; код функции 048 
оу АГ, 1 ; включить звуковой сигнал 
16 166 ; вызываем прерывание 


3.2.6. Функция 05В 


Данная функция позволяет записать определенный символ в буфер клавиа- 
туры. Особенность функции состоит в том, что она позволяет имитировать 
нажатия клавиш. 


Использование: 

|. В регистр Ан следует поместить код функции 058. 

2. В регистр сн необходимо занести скан-код нужной клавиши. 
3. В регистр съ нужно записать АЗСП-код той же клавиши. 

4. Вызвать прерывание 1пе 168. 
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Выход: 


После выполнения функции регистр ль будет хранить результат операции: 
00» — функция успешно завершена, 01н — функция не выполнена из-за пе- 
реполнения буфера клавиатуры. Если функция не завершена, будет уста- 
новлен флаг сг. Пример записи в буфер клавиатуры символа ‘а’ показан 
в листинге 3.6. 


Листинг 3.6. Использование функции 058 


поу АН, 5 ; код функции 058 

пох СН, 30 ; скан-код буквы 'а' равен 1ЕВ 
шоу СЁ, 'а' ; АЗСТТ-код буквы 'а' 

Зое 16 ; вызываем прерывание 


Кроме того, данную функцию можно использовать для записи в буфер ка- 
кой-либо команды ОО (например, рАТЕ), используя только АЗСИ-коды 
(листинг 3.7). 





Листинг 3.7. Использование функции 055 для выполнения строковой команды 
поУ СЫ, "а' ; запишем в регистр букву 'а' 

са]11 зеёраЕЁЕег ; и отправим в буфер клавиатуры 

оу СЫ, 'а' ; запишем в регистр букву 'а' 

са11 зе БаЕЕег ; и отправим в буфер клавиатуры 

поУ СЫ, '{' ; запишем в регистр букву '®' 

са11 зебраЕЕег ; и отправим в буфер клавиатуры 

поУ СШ, 'е' ; запишем в регистр букву *е' 

са11 зеёЪоаЕЁЕег ; и отправим в буфер клавиатуры 

поу СЫ, ОАВ ; запишем в регистр символ перевода строки 
са11 зе ЪоЕЕег ; и отправим в буфер клавиатуры 

оу СЫ, ООВ ; запишем в регистр символ возврата каретки 
са11 зебриЕЁЕег ; и тоже отправим в буфер клавиатуры 


геё ; выходим из программы 

зебраЕег ргос ; процедура для записи байта в буфер клавиатуры 
оу АН, 5 ; код функции 058 

поУу СН, 0 ; скан-код не используем 

1706 16 ; вызываем прерывание 


зебраЕЕег епар ; окончание процедуры 


3.2.7. Функция 09В 


Эта функция позволяет определить набор функций, поддерживаемых кла- 
виатурой, и, соответственно, узнать ее тип (84, 102 или 122 клавиши). Оп- 
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ределить, поддерживается ли эта функция В10$, можно с помощью функ- 
ции сов прерывания 10% 158. 


Использование: 
1. В регистр Ан следует поместить код функции оэн. 


2. Вызвать прерывание +пЕ 161. 


Выход: 


После выполнения функции регистр Ат, будет хранить битовую маску под- 
держиваемых функций. Формат ‘битовой маски представлен в табл. 3.8. 


Таблица 3.8. Битовая маска набора функций 
Бит Описание 


0 — Поддержка функции 0300ъ прерывания зпе 161 (1 — поддерживается, 
0 — не поддерживается) 


1 — Поддержка функции 0304в прерывания 11 165 (1 — поддерживается, 
0 — не поддерживается) 


2 — Поддержка функции 0305ъ прерывания 1пе 161 (1 — поддерживается, 
0 — не поддерживается} 


3 Поддержка функции 03065 прерывания 1пе 161 (1 — поддерживается, 
0 — не поддерживается) 


4 — Поддержка функции оль прерывания +116 168 (1 — поддерживается, 
0 — не поддерживается) 


5 Поддержка функций 105; 111 и 125 прерывания 11 161 (1 — поддерживаются, 
0 — не поддерживаются} 


6 — Поддержка функций 20ъ, 21в и 225 прерывания 1пе 16. (1 — поддерживаются, 
0 — не поддерживаются) 


7 Резерв 


Например, чтобы узнать, поддерживает ли клавиатура функции 20—22. 
(122-клавишная), нужно написать код, показанный в листинге 3.8. 





поу АН, 9 ; код функции 098 


1 168 ; вызываем прерывание 
апа А1, 40. ; проверяем бит 6 
312 ЕггогНниа ; функции не поддерживаются 
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3.2.8. Функция ОАР 


Функция позволяет получить идентификатор установленной клавиатуры. 
Перед вызовом этой функции следует вызвать функцию 09ъ, чтобы убедить- 
ся в ее поддержке В1О$5. 


Использование: 
|. В регистр Ан следует поместить код функции одь. 


2. Вызвать прерывание 1пе 161. 


1ход: 
эсле выполнения функции регистр вх будет хранить идентификатор кла- 
татуры: 00005 — клавиатура отсутствует, 41АВЬ, 54АВЬ, ЗЗАВЬ, 84АВЬ — ЯПОН- 
‚ая клавиатура, з6Авь — 122-клавишная клавиатура. Рассмотрим пример 
получения идентификатора подключенной клавиатуры (листинг 3.9). 





Листинг 3.9. Использование функции САБ 


поу АН, ОАБ ; код функции ОАБ 

10 168 ; вызываем прерывание 

сир ВХ, 0 ; проверяем наличие клавиатуры 
32 МоКеуь ; клавиатура не подключена 


сир ВХ, 86АВЬ ; 122 клавиши 
32 МоКеуЬ 122; не 122-клавишная 


3.2.9. Функция 108 


Данная функция позволяет прочитать любой символ с расширенной кла- 
виатуры. Похожа на функцию 00%, но поддерживает расширенный набор 
СИМВОЛОВ. 


Использование: 
1. В регистр Ан следует поместить код функции 101. 


2. Вызвать прерывание 1пе 165. 


Выход: 


После выполнения функции в регистр Ан будет помещен скан-код В10$ 
символа из расширенного набора, а в регистр Аь — АЗСП-код символа. 


» 


3.2.10. Функция 11А 


Функция позволяет проверить нажатие клавиши на расширенной клавиату- 
ре. Если клавиша была нажата, функция запишет в соответствующие реги- 
стры скан-код и АЗСП-код клавиши. Похожа на функцию о00ъ, только под- 
держивает расширенный набор символов. 


Глава 3. Клавиатура 93 


Использование: 

1. В регистр Ан следует поместить код функции 111. 

2. Вызвать прерывание 1пе 161. 

Выход: 

После выполнения функции в регистр Ан будет помещен расширенный 
скан-код ВОЗ символа, а в регистр Ат — АЗСП-код символа. Кроме того, 


если нажатия клавиши не было, флаг 2е будет установлен в 1. Если клавиша 
была нажата, флаг 2 будет сброшен. 


3.2.11. Функция 121 


Эта функция позволяет получить состояние специальных клавиш на расши- 
ренной клавиатуре: <ЗШИ>, <СЫ>, <АШ>, <Мит Госк>, <$сгоЙ ШюосК>, 
<Сарз ГосКк>, <ЗузКеа> и <тзец>. 


Использование: 
1. В регистр Ан следует поместить код функции 12,1. 


2. Вызвать прерывание 1п+ 161. 


Выход: 
После выполнения функции регистр Ах будет хранить значение состояния 
специальных клавиш. Формат возвращаемого значения представлен в табл. 3.9. 


Таблица 3.9. Формат значения о состоянии расширенной клавиатуры 


Бит Описание 


[> 


Правая клавиша ЗН (1 — нажата, 0 — не нажата) 
Левая клавиша ЗИ (1 — нажата, 0 — не нажата) 

Любая клавиша СШ (1 — нажата, 0 -- не нажата} 

Любая клавиша АК (1 — нажата, 0 — не нажата) 
Переключатель Зсгой |1 осК (1 — включен, 0 — выключен) 
Переключатель Мит [оск (1 — включен, 0 — выключен) 
Переключатель Сарз [оск (1 — включен, 0 — выключен) 
Переключатель 1пзек (1 — включен, 0 — выключен) 


Левая клавиша С\ (1 — нажата, 0 — не нажата) 


юо чо рот - 


Левая клавиша АК (1 — нажата, 0 — не нажата) 


_ 
[> 


Правая клавиша СШ (1 — нажата, 0 — не нажата) 


> 
> 


Правая клавиша АН (1 — нажата, 0 — не нажата) 
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Таблица 3.9 (окончание) 


Бит Описание 


12 Клавиша Зсго! ГоскК (1 — нажата, 0 — не нажата) 
13 Клавиша Мит Ёоск (1 — нажата, 0 — не нажата} 
14 Клавиша Сарз [оск (1 — нажата, 0 — не нажата) 


15 Клавиша ЗузВеча (1 — нажата, 0 — не нажата) 


3.2.12. Функция 205 


Функция позволяет прочитать любой символ с расширенной клавиатуры. 
Похожа на функцию 10%, только поддерживает 122-клавишные клавиатуры. 
Использование: 

|. В регистр дн следует поместить код функции 205. 


2. Вызвать прерывание 11% 161. 


Выход: 


После выполнения функции в регистр Ан будет помещен скан-код В10$ 
символа из расширенного набора, а в регистр Ат — А$СП-код символа. 


3.2.13. Функция 211 


Данная функция позволяет проверить нажатие клавиши на расширенной 
клавиатуре. Если клавиша была нажата, функция запишет в соответствую- 
щие регистры скан-код и АЗСП-код клавиши. Похожа на функцию 11, 
только поддерживает 122-клавишные клавиатуры. 

Использование: 

|. В регистр Ан следует поместить код функции 211. 


2. Вызвать прерывание 1пе 161. 


Выход: 

После выполнения функции в регистр Ан будет помещен расширенный 
скан-код В1О$ символа, а в регистр Ат. — АЗСП-код символа. Кроме того, 
если нажатия клавиши не было, флаг 22 будет установлен в 1. Если клавиша 
была нажата, флаг 2г будет сброшен. 


3.2.14. Функция 225 


Эта функция позволяет получить состояние специальных клавиш на расши- 
ренной клавиатуре: <ЗМЙ>, <СШ1>, <АШ>, <Мит ЁосК>, <ЗстоЙ РосК>, 
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<Сарз Госк>, <ЗузКеа> и <шзеп>. Похожа на функцию 111, только под- 
держивает 122-клавишные клавиатуры. 

Использование: 

1. В регистр Ан следует поместить код функции 22. 


2. Вызвать прерывание 11% 168. 


Выход: 


После выполнения функции регистр Ах будет хранить значение состояния 
специальных клавиш. Формат возвращаемого значения был представлен в 
табл. 3.9. 


3.2.15. Функция РЕВ 


Функция позволяет добавить символ в конец буфера клавиатуры. 


Использование: 
1. В регистр Ан следует поместить код функции ЕЕК. 


2. В регистр рх следует записать скан-код желаемого символа. 


3. Вызвать прерывание 3% 161. 


Выход: 


После выполнения функции регистр Ат будет хранить результат операции: 
005 — успешное выполнение, 01. — произошла ошибка. Попробуем в сле- 
дующем примере (листинг 3.10) записать в буфер клавиатуры скан-код бук- 


поу АН, ОРЕН ; код функции ЕЕК 

оу ПХ, 101 ; скан-код буквы 'О' равен 108 
116 168 ; вызываем прерывание 

{$езЕё АП, АБ ; проверка на 0 

)]2  ЕггогНрА ; произошла ошибка 


На этом примере можно завершить рассмотрение функций В!О$ и перейти 
к программированию портов контроллера клавиатуры. 


3.3. Использование портов 


Клавиатура и мышь в современных компьютерах работают по протоколу 
Р5$/2 и обе подключаются к общему контроллеру клавиатуры (например, 
пе! 8042), интегрированному в чип (микросхему) на материнской плате. 
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Для клавиатуры контроллер генерирует прерывание тво1. Контроллер может 
работать в двух режимах: Р$/2-совместимом и АТ-совместимом. Первый 
режим предусматривает поддержку двух устройств: мыши и клавиатуры. 
Доступ к контроллеру клавиатуры осуществляется через порты 60н и 64ь. 
Порт 60в в режиме чтения получает данные из буфера клавиатуры, а в ре- 
жиме записи помещает данные в буфер. Порт 64в тоже работает в двух ре- 
жимах: в режиме чтения он является регистром состояния, а в режиме запи- 
си выполняет роль регистра команд. Формат регистра состояния (64н)} пред- 
ставлен в табл. 3.10. 


Таблица 3.10. Регистр состояния (641) 


Бит Описание 





0 Наличие данных в выходном буфере клавиатуры (0 — выходной буфер 
пустой, 1 — в буфере есть данные) 


1 Наличие данных во входном буфере клавиатуры (0 — входной буфер пустой, 
1 — в буфере есть данные) 


Результат самотестирования (0 — сброс, 1 — тест прошел успешно) 
Порт, используемый для последней операции (0 — в0ъ, 1 — 64к) 
Состояние клавиатуры (0 — заблокирована, 1 — включена) 

Ошибка передачи (0 — ошибок нет, 1 — клавиатура не отвечает) 


Ошибка тайм-аута (0 — ошибка отсутствует, 1 — ошибка) 


ччоаъо 


Ошибка четности (0 — ошибка отсутствует, 1 — ошибка) указывает 
на последнюю ошибку, произошедшую при передаче данных 


Формат регистра команд (64ъ) показан в табл. 3.11. 


Таблица 3.11. Регистр команд (648) 


Бит Описание 


0 Прерывания для клавиатуры (0 — отключить, 1 — включить) 
Прерывания для мыши (0 — отключить, 1 — включить) 


Системный флаг (1 — инициализация через самотестирование, 
0 — инициализация по питанию) 


Не используется 
Доступ к клавиатуре (0 — открыт, 1 — закрыт) 
Доступ к мыши (0 — открыт, 1 — закрыт) 


Трансляция скан-кодов (0 — не использовать, 1 — использовать) 


ола ьтро 


Резерв 
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Перед началом работы с клавиатурой следует проверить наличие данных в 
буфере (бит 0 в регистре статуса). Кроме того, такую проверку необходимо 
выполнять перед любыми последующими операциями записи. После про- 
верки буфера в регистр 64п записывается код желаемой команды 
(табл. 3.12). Если команда имеет дополнительные параметры, их следует за- 
писать в регистр данных (601). После выполнения команды в регистр дан- 
ных (601) будет помещен результат (табл. 3.13). 


Таблица 3.12. Команды управления контроллером клавиатуры 


Ко 
д Описание 
команды 

208 Прочитать байт из регистра команд 

601 Записать байт в регистр команд 

АВ Получить номер версии производителя 

ААВ Получить пароль (возвратит гАБ, если пароль существует, и = — 
в обратном случае) 

АЗП Установить пароль (побылает строку с нулевым символом в конце) 

Аб Проверить пароль (сравнивает введенный с клавиатуры пароль с текущим) 

ААВ Выполнить самотестирование контроллера (в случае успеха возвратит 
55.) 

АВЬ Проверка интерфейса клавиатуры (00. — все хорошо, о1в — низкий уро- 
вень сигнала синхронизации, 02. — высокий уровень сигнала синхрони- 
зацим, озв — низкий уровень сигнала на линии данных, 04н — высокий 
уровень сигнала на линии данных) 

АБВ Отключить интерфейс клавиатуры (устанавливает бит 4 в регистре 
команд) 

АЕБ Включить интерфейс клавиатуры (очищает бит 4 в регистре команд} 

АЕП Получить версию 

сов Прочитать входной порт 

ров Прочитать значение из выходного порта 

ов Записать параметр в выходной порт 

О2в Записать параметр в буфер клавиатуры 

вов Тестирование порта (возвращает тестовое значение для порта} 





Рассмотрим несколько примеров использования управляющих команд. Сна- 
чала напишем код, который выполняет проверку интерфейса (команда аАВЬ) 
клавиатуры (листинг 3.11). 
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Таблица 3.13. Коды ошибок клавиатуры 


Код ошибки Описание 


ов Ошибка переполнения (слишком много нажатий клавиш) 
ААВ Самотестирование контроллера успешно завершено 

ЕЕВ Результат эхо-режима, инициированного командой ЕЕБ 
РАВ Подтверждение успешного выполнения команды 

КСВ Ошибка самотестирования клавиатуры 

ЕЕВ Запрос на повторную передачу данных (команда везепа) 
ЕЕВ Ошибка клавиатуры 





; ждем освобождения входного буфера клавиатуры 
@Кеубр миаз: 


п АЬ, 648 ; опрашиваем регистр состояния 
сезЕ АЦ, 0106 ; если буфер занят 
п; @Кеур ма1е; повторяем опрос 





поу АП, ОАВЬ ; команду тестирования интерфейса 
оцЕ 641, АЁ ; записываем в порт 


Для программистов С++ этот пример представлен в листинге 3.12. 
Листинг 3.12. Проверка наличия клавиатуры в С++ 
ОИОВР ЧмВезо1Е = 0; // переменная для хранения результата 
17Е 1ТиаейазЕ = 50000; 
// проверяем наличие данных во входном буфере клавиатуры 
"й11е ( -- 1Т1меМмале > 0) 
{ 
// читаем состояние порта 
1пРоге ( 0х%х64, &ЧмКезо16, 1); 
1Е ( ( амВезо1Е & 0х02) == 0х00) БгеаК; 
// закончилось время ожидания 
3Е ( 1ТпаеМа1® < 1) гебагп МУ ЕВВОВ_ТТМЕ; 
} 
// записываем в порт команду проверки интерфейса 
опЕРогЕ ( 0х64, ОхАВ, 1); 
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Теперь попробуем отключить клавиатуру. Для этого применим управляю- 
щую команду с кодом Арн так, как это сделано в листинге 3.13. 





; ждем освобождения входного буфера клавиатуры 


@Кеур мате: 

ш АБ, 640 ; опрашиваем регистр состояния 
{езЕ АЬ, 0106 ; если буфер занят 

02 @Кеуб ма1е; повторяем опрос 

поу АГ, ОАША ; команду отключения клавиатуры 


сие 641, АЁ ; записываем в порт 


Аналогичный пример для С++ показан в листинге 3.14. 





Листинг 3.14. Отключение клавиатуры в С++ 
ОИОВО 9мВезиц1Е = 0; // переменная для хранения результата 
Пи 1Томема1е = 50000; 
// проверяем наличие данных во входном буфере клавиатуры 
уве ( -- 1Тилемазе > 0) 
{ 

// читаем состояние порта 

1пРоге ( 0х64, &амВези1*, 1); 

1Е ( (ЧмВезо1Е & 0х02) == 0х00) Бгеак; 

// закончилось время ожидания 

1Е ( 1ТНейма1е < 1) гебагр МУ ЕВВОВ_ТТМЕ; 
} 
// записываем в порт команду отключения клавиатуры 
оиЕРогЕ ( 0х64, ОхАБ, 1); 


Чтобы восстановить работу клавиатуры, запиишгите в регистр команд код АЕБ. 
Как видно из примеров, работа с командами управления не вызывает про- 
блем. Кроме перечисленных ранее команд управления контроллером кла- 
виатуры. существует еще ряд дополнительных команд, которые применяют- 
ся для настройки различных режимов работы устройства и управления 
встроенным в клавиатуру процессором. Список этих команд представлен в 
табл. 3.14. Команды могут иметь дополнительные параметры, которые пере- 
даются в виде дополнительного байта. Код команды следует записать в порт 
505. После посылки каждой команды следует проверить бит 1 для порта 64ъ 
и только при его сбросе (равенстве 0) передавать дополнительный параметр. 
Кроме того, можно проверить нулевой бит в порту 60%. После выполнения 
каждой команды, кроме кЕв и ЕЕВ, возвращается подтверждающий код ЕАБ 
(читается из порта вон). Если значение кода команды или параметра недо- 
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пустимы, клавиатура вернет код ЕЕв. Если вместо дополнительного байта 
параметра послать код новой команды, клавиатура выполнит именно его, 


"забыв” о предыдущей команле. 


Таблица 3.14. Набор команд для клавиатуры 





Код команды Описание 





БОВ Установить или сбросить состояние индикаторов 

ЕЕВ Выполнить эхо-диагностику клавиатуры 

кон Выбрать набор скан-кодов (первый, второй или третий) 

Е2Ь Получить идентификатор клавиатуры 

РЗВ Настроить параметры автоповтора и время задержки 

кан Включить клавиатуру (буфер будет очищен) 

Е5В Отключить клавиатуру и загрузить значения по умолчанию 

ЕбН Установить значения параметров, используемых по умолчанию 
(10 символов/с, 500 мс) 

Е7В Установить режим автоповтора для всех клавиш 

ЕВВ Установить для всех клавиш передачу кодов нажатия и отпускания 

ЭП Установить для всех клавиш передачу кодов нажатия 

КАЙ Установить для всех клавиш передачу кодов нажатия, отпускания 
и режим автоповтора 

ЕВЬ Установить для указанной клавиши передачу кодов нажатия 
и режим автоповтора 

ЕСВ Установить для указанной клавиши передачу кодов нажатия 
и отпускания 

ЕОВ Установить для указанной клавиши передачу кодов нажатия 

КЕВ Выполнить повторную передачу последнего переданного байта 

РЕН Сброс клавиатуры 


Некоторые команды требуют дополнительного описания, поэтому рассмот- 
рим их более подробно. 


3.3.1. Команда ЕОВ 


Данная команда позволяет управлять состоянием индикаторов на клавиа- 
туре. Размер команды равен двум байтам. Первый байт содержит сам 
код команды, а второй — битовую маску для настройки индикаторов 
(табл. 3.15). 
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Таблица 3.15. Байт состояния индикаторов 


Бит Описание 


0 Индикатор Зсто! Госк (1 — включен, О — выключен) 

1 Индикатор Мит 1 оск (1 — включен, 0 — выключен) 

2 Индикатор Сарз Госк (1 — включен, 0 — выключен) 
3—7 Резерв 


Приведу простой пример для управления индикатором <Мит Коск> (лис- 
тинг 3.15). 





@Кеуь мат: 


1 АБ, 64В ; опрашиваем регистр состояния 
{езЕ АГ, 010 ; если буфер занят 

)12 @Кеубр ма1Е; повторяем опрос 

поу АГ, ОЕОК ; команду управления индикаторами 
оцЕ 605, АБ ; записываем в порт данных 

Чата ма1%: 

1 АБ, 648 ; опрашиваем регистр состояния 
СезЕ АБ, 0106 ; если буфер занят 

302 @Чака_ма1е; повторяем опрос 





поу АГ, 0106 ; включаем №ла ТШоск 
о0Е 601, АБ ; записываем в порт значение 


Для С++ аналогичный пример показан в листинге 3.16. 


Листинг 3.16. Управление индикатором <Мит ЁЬоск> в С++ 


ОИОВО ЧмВези1& = 0; // переменная для хранения результата 
1106 1Тимейа1Е = 50000; 
// проверяем наличие данных во входном буфере клавиатуры 
\р11е ( -- 1ТилеМма1® > 0) 
{ 

// читаем состояние порта 

1пРоге ( 0х64, &ЧмВези1&, 1); 

1Е ( (ЧмВеза1 & 0х02) == 0х00) ргеак; 

// закончилось время ожидания 

1Е ( 1Т]меМма1® < 1) гебагп МУ ЕВВОК ТТМЕ; 
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// записываем в порт команду управления индикаторами 
очЕРогЕ ( 0х60, ОхЕО, 1); 
1106 1Тилейа1® = 50000; 
// проверяем наличие данных во входном буфере клавиатуры 
м111е ( -- 1Т1мемате > 0) 
{ 
// читаем состояние порта 
1пРогЕ ( 0х64, &ЧмВези1%, 1); 
1Е ( (ЗмВеза1 & 0х02) == 0х00)} ргеак; 
// закончилось время ожидания 
1Е ( 1Т1еМма1е < 1) гебогп МУ ЕВВОВ ТТМЕ 





<. 


} 
опЕРогЕ ( 0х60, 0х02, 1); 


3.3.2. Команда ЕЕВ 


Команда позволяет протестировать клавиатуру на предмет работоспособ- 
ности. Если в работе клавиатуры возникли сбои, следует сделать сброс 
(команда гЕВ) и послать эту команду. Возврашаемое значение, отличное от 
ЕЕв, ЯВНО укажет на сбои в работе клавиатуры. Возможно, придется даже 
отключить и повторно включить питание для восстановления нормальной 
работоспособности устройства. 


3.3.3. Команда Е2В 


Эта команда позволяет получить идентификатор клавиатуры и убедиться в 
ее наличии. После выполнения команды клавиатура вернет код подтвер- 
ждения ЕАв, а затем идентификатор: для большинства клавиатур это два ко- 
да — аВВ и 831 (для отдельных клавиатур 41н). Рассмотрим простой пример 
получения идентификатора клавиатуры, описанный в листинге 3.17. 


Листинг 3.17. Получение идентификатора клавиатуры 





@кеую ма: 
п Г, 64В ; опрашиваем регистр состояния 
сезЕ АГ, 0106 ; если буфер занят 
907 Кеуб ма1%; повторяем опрос 

Г, ОЕ2й $; команду зхо-диагностики 


Оп, АБ ; записываем в порт данных 


З 

ре 

< 
рроорорр 





Са11 @аафа_ма1 
ЗП Г, 60В ; получаем подтверждение 
сир Т, ОГАП ; выполнения команды 


Зпе ЕггогНрЯ ; произошла ошибка 
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са11 @дата мал 

шт АБ, 608 ; получаем подтверждение 

сфр АГ, ОАВЛП ; первый байт идентификатора 
зле ЕггогНра ; произошла ошибка 

са11 @Часа_ма1® 

1 АБ, 608 ; получаем подтверждение 

стр АЪ, 83. ; второй байт идентификатора 
зле ЕггогНпа ; произошла ошибка 

геё 

@Чафа_ма1е: 

ш АБ, 64В ; опрашиваем регистр состояния 
сезЕ АБ, 016 ; если буфер занят 

}12 @дафа_ма1е; повторяем опрос 

гее 





В данном примере мы послали команду Ег2в контроллеру клавиатуры и по- 
следовательно получили три байта: байт подтверждения и два байта иден- 
тификатора клавиатуры. Аналогичный код для С++ приведен в листин- 
ге 3.18. 


Листинг 3.18. Получение идентификатора клавиатуры в С++ 


// для удобства работы пишем отдельную функцию опроса данных в буфере 
роо] Ма1ЕБафа () 
{ 
// переменная для хранения результата 
ОИОВО амВези1 = 0; 
106 1Туиейа1е = 50000; 
// проверяем наличие данных во входном буфере клавиатуры 
ир11е ( -- 1Тшлема1® > 0) 
{ 
// читаем состояние порта 
10Рог® ( 0х64, &дмВези1*, 1); 
1Е ( (@мВези1* & 0х01) == 0х00)} гебоаги 6гце; 
// закончилось время ожидания 
1Е ( 1Т3шейа1% < 1) гебогп Еа15е; 
} 
тебсогп Еа1зе; 
} 
// основной код программы 
ОМОВО амВези1Е = 0; 
116 1Тплема1* = 50000; 
// проверяем наличие данных во входном буфере клавиатуры 
м811е ( -- 1Тлейа1® > 0) 
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// читаем состояние порта 
1оРоге ( 0х64, &ЗмВеза1е, 1); 
1Е ( (ЧмВези1 & 0х02) == 0х00) Бгеак; 
// закончилось время ожидания 
1Е ( 1Тымема1е < 1) гебагп МУ ЕВВОВ_ТТМЕ; 
. 
опЕРогеЕ ( 0х60, 0хЕ2, 1); // записываем код команды 
// ждем получения первого байта 
1Тилема1е = 50000; 
1Е ( Ма1ебаха ()) // получен 
{ 
1пРогЕ ( 0х60, &ЧмВезо1%, 1); 
// проверяем на равенство коду РАБ 
1Е ( ЧмВезо1% != ОхгА) 
тебигп МУ _ЕВВОВ; 
} 
е1зе // нет данных 
тесогп МУ ЕВВОВ; 
// ждем получения второго байта 
1ТиеМа1е = 50000; 
1Е ( Ма1ераба ()) // получен 
{ 
1оРогЕ ( 0х60, &ЧмВезо1е, 1); 
// проверяем на равенство коду АВЫ 
1Е ( ЧмВеза1% != ОхАВ) 
тебсогп МУ ЕВВОВ; 
} 
е1зе // нет данных 
тееигп МУ ЕВАОВ; 
// ждем получения третьего байта 
1ТтмеМма1Е = 50000; 
1Е ( Иазераба ()) // получен 
{ 
1пРогЕ ( 0х60, &9мВези1е, 1); 
// проверяем на равенство коду 838 
1Е ( ЧмВеза1% != 0х83) 
гесигп МУ _ЕВВОВ; 
} 
е1зе // нет данных 
гесагп МУ_ЕВАОВ; 
// идентификатор клавиатуры успешно получен 
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3.3.4. Команда ЕЗВ 


Данная команда позволяет установить частоту и время задержки для авто- 
матического повтора набранного на клавиатуре символа. Размер команды 
равен двум байтам. Первый байт содержит сам код команды, а второй — 
описание параметров настройки автоповтора (табл. 3.16). 


Таблица 3.16. Содержание байта настройки автоповтора 


Биты Описание 
0—4 Код значения частоты автоповтора 
5—6 Код значения времени задержки 


7 Резерв 


Колы значений частоты автоповтора и времени задержки были представле- 
ны соответственно в табл. 3.7 и 3.6. Простой пример использования коман- 
ды ЕЗр показан в листинге 3.19. 





@Кеур мал: 


ш №, 645 ; опрашиваем регистр состояния 
{езЕ АГ, 0105 ; если буфер занят 

312 @КеуЪ иа1е; повторяем опрос 

поу АП, ОРЗА ; команду ЕЗЬ 





оиЕ 601, АБ ; записываем в порт данных 
@Часа_ ма1е: ; есть ли ответ 

ш АБ, 64В ; опрашиваем регистр состояния 
{езЕ АГ, 015 ; на наличие данных 


)]2  @Чата ма1е; повторяем опрос 


ш А, 60 ; получаем подтверждение 

спр АБ, ОКАБ ; выполнения команды 

Зпе ЕггкохНпА ; произошла ошибка 

@кеур малЕ: 

ш АГ, 646 ; опрашиваем регистр состояния 


{езЕ АГ, 0105 ; если буфер занят 
312 @Кеур ма1е; повторяем опрос 





поу АБ, 281 ; 15 символов/с и 750 мс 
очЕ 601, АБ ; записываем в порт данных 


Аналогичный код для установки параметров автоповтора (частота 15 симво- 
лов/с.и время 750 мс) для С++ представлен в листинге 3.20. 
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Листинг 3.20. Использование команды ЕЗь в С++ 
ОИОВР амВезо1е = 0; 
106 1ТилеМате = 50000; 
// проверяем наличие данных во входном буфере клавиатуры 
\?1]е (-- 1Тиема1е > 0) 
{ 
// читаем состояние порта 
1пРокб ( 0х64, &амКезо1%, 1); 
1Е ( (ЯмВези16 & 0х02) == 0х00) Бгеак; 
// закончилось время ожидания 
1Е ( 1Тлема1е < 1) гебагр МУ ЕВВОВ_ТТМЕ; 
} 
очЕРокЕ ( 0х60, ОхРЗ, 1); // записываем код команды 
106 1Типема1е = 50000; 
// проверяем наличие данных во входном буфере клавиатуры 
у21]е ( -- 1ТиеЙа1® > 0) 
{ 
// читаем состояние порта 
1пРоге ( 0х64, &ЧмВези1е, 1); 
1Е ( (ЗмВеза1е & 0х01) == 0х00) Бкеак; 
// закончилось время ожидания 
1Е ( 1Т1щеМа16 < 1) гебаго МУ ЕАВОВ Т1МЕ; 
) 
1пРокб ( 0х60, &амВезо16, 1); 
// проверяем на равенство коду РАБ 
1Е ( амВези1е != ОхРА) кебагп МУ ЕВВОВ; 
1Тииема1* = 50000; 
// проверяем наличие данных во входном буфере клавиатуры 
У111е ( -- 1Тилемале > 0) 
{ 
// читаем состояние порта 
1пРогф ( 0х64, &амВеза1е, 1); 
1Е ( (АмВези1е & 0х02) == 0х00) Бгеак; 
// закончилось время ожидания 
1Е ( 1ТплаеМма1е < 1) гебакп МУ ЕВВОВ ТТМЕ; 
} 
// записываем значение частоты и время задержки 
сиЕРоЕЕ ( 0х60, 0х28, 1); 


Остальные функции управления достаточно просты и не требуют дополни- 
тельных примеров. Если сравнить программирование клавиатуры с исполь- 
зованием прерывания 1пе 165 и непосредственно портов, то первый способ 


Глава 3. Клавиатура 


107 


окажется гораздо более удобным. Однако доступ посредством аппаратных 
портов дает выигрыш (незначительный) в скорости и позволяет применять 
весь набор команд для любых случаев. В конечном итоге выбор остается за 
программистом. Для удобства работы приведу дополнительно скан-коды 
клавиш (второй набор), используемых во всех современных клавиатурах 


(табл. 3.17). 








Клавиша 








Е5 03 
26 ов 
Р7 83 
Е8 0А 
Е9 01 
210 09 
Е11 78 
Е12 07 
0 45 
1 16 
2 1Е 
3 26 
4 25 
5 2Е 
6 36 
7 ЗЬ 








Таблица 3.17. Второй набор скан-кодов клавиатуры 


ЕО, 
ЕО, 
ЕО, 
ЕО, 
ЕО, 
ЕО, 
ЕО, 
ЕО, 
ЕО, 
ЕО, 
ЕО, 
ЕО, 
ЕО, 
ЕО, 


ЕО, 


ЕО, 


03 
ов 
83 
ОА 
01 
09 
78 
07 
45 
16 
1Е 
26 
25 
2Е 


36 


ЗВ 


Клавиша 


ВасК$расе 
ТаБ 
Зрасе 
Сар$ осКк 
Езс 
Емщег 
ев См 
Вам С 
Гей АК 
Вом АК 
ей ЗЫ 
Рам ЗЫ 
Гей М/т 
Аюм МИ 
Аррз 


Риг{ Зсгееп 


Эсгой Боск 


Рачзе 





Код 
нажатия 


ЕО, 11 











Код 


отпускания 


ЕО, 

















ЕО, 7С 
ЕО, 12 
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Код 
нажатия 
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Код 
отпускания 








ттоттоооъ 





<< ас зоо зо>2 с хеса 


2 
(1Е) Зеагсй 
(1Е) Ноте 
(Е) Зюр 





2В 


34 
33 
43 
ЗВ 
42 
4В 
ЗА 
31 
44 
4 
15 
20 
1В 
2С 
с 
2А 
1 
22 
35 


1А 








ЕО, 
ЕО, 
ЕО, 
ЕО, 
ЕО, 
ЕО, 
ЕО, 
ЕО, 
ЕО, 
ЕО, 
ЕО, 
ЕО, 
ЕО, 
ЕО, 
ЕО, 
ЕО, 
ЕО, 
ЕО, 
ЕО, 


ЕО, 


ЕО, 





2В 
34 
33 
43 
ЗВ 
42 
4В 
ЗА 
31 
44 
4р 
15 
20 
1В 
2С 
с 
2А 
10 
22 
35 


1А 







Таблица 3.17 (продолжение) 


Клавиша 


/ 
|пзец 
Ноте 
Обеее 
Епа 
Раде Ур 
Раде Оомп 
Ур Атом 
Вомп Атом 
тей Атом 
Рам Атом 
Мит Боск 


(+) Емег 





Код 


нажатия 


74 


5А 


4А 








Код 


отпускания 





ЕО, 
ЕО, 
ЕО, 
ЕО, 


ЕО, 





РО, 70 


РО, 74 


ЕО, 77 


ЕО, 


ЕО, 





ЕО, 5А 


ЕО, 4А 


го, 7С 
ГО, 7В 
РО, 79 
ГО, 71 
го, 70 
го, 69 
ГО, 72 
ГО, 7А 
го, 6В 


ГО, 73 
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Таблица 3.17 (окончание) 



























Клавиша Код Код Клавиша Код 
нажатия | отпускания нажатия | отпускания 
(Е) ВенезН (+) 6 
(Е) Ропмага ЕО, 30 | ЕО, ЕО, 30 (+)7 6с 20, 6С 
(Е) Васк ЕО, 38 ЕО, ЕО, 38 (+) 8 75 ЕО, 75 
(Е) Рауоез ЕО, 18 ЕО, РО, 18 (+) 9 7 ЕО, 7 
Моште Ур ЕО, 32 ЕО, ЕО, 32 Мех! Тгаск ЕО, 42 | ЕО, ЕО, 40 
\оите ОБо\мип ЕО, 21 ЕО, ЕО, 21 | Ргемюицз$ Тгаск ЕО, 15 ЕО, ЕО, 15 
Мише ЕО, 23 ЕО, ЕО, 23 М/аке ЕО, 5Е | ЕО, ЕО, 5Е 
Рау ЕО, 34 ЕО, ЕО, 34 Ро\мег ЕО, 37 ЕО, ЕО, 37 
Зюр Зеер 











Существует еще один порт 615, используемый в современных компьютерах 
для управления встроенным динамиком (спикером). Он служит для чтения 
и записи и позволяет управлять некоторыми функциями клавиатуры (ради 
совместимости со старыми моделями). Формат регистра 61ь представлен 
в табл. 3.18. 


Таблица 3.18. Формат регистра 615 


Бит Описание 
0—5 — Для клавиатуры не используются 
6 Низкий уровень сигнала на линии синхронизации 


7 Отключение клавиатуры (1 — выключить, 0 — включить) 


Как видно из таблицы, для работы с клавиатурой отведены только два бита: 
би 7. Остальные изменять не рекомендуется. Например, чтобы отключить 
клавиатуру, следует написать код, приведенный в листинге 3.21. 





Листинг 3.21. Отключение клавиатуры с помощью портов 





Ш АБ, бЩ ; прочитать состояние порта 
ог АШ, 808 ; выполнить побитовую операцию ИЛИ 
оцЕ 611, АБ ; выключить клавиатуру 


Для включения заблокированной клавиатуры можно использовать код из 
листинга 3.22. 
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: Листинг 3.22. Включение клавиатуры с помощью портов | 


11 АБ, 618 ; прочитать состояние порта 
апа АБ, 011111118 ; нужно обнулить бит 7 для включения клавиатуры 
оц 611, А ; записать значение в порт 


Для С++ аналогичный код представлен в листинге 3.23. 


Листинг 3.23. Включение и отключение клавиатуры с помощью портов в С++ 


// нишем функцию управления клавиатурой 
уо1А РоскИп1оскККеуБоага ( 5оо1 ЮЁоск) 
{ 
ОИОВО ЧмВези1* = 0; 
1Е ( Боск) // блокировать 
{ 
1пРогЕ ( 0х61, амВезо1е, 1); 
ЧмВези1е |= 0х80; 
опЕРохге ( 0х61, ЧмВези1е, 1); 
} 
е15е // разблокировать 
{ 
1пРогЕ ( 0х61, амВезо1е, 1); 
ЧмВези1е &= Ох7Е; 
опЕРоге ( 0х61, АмВези1е, 1); 


А теперь посмотрим, какие возможности по управлению клавиатурой пре- 
доставляет программный интерфейс \\М!п32. 


3.4. Использование \!тз2 АР! 


` Возможности интерфейса \Ут32 АРГ "традиционно" скромны и ограничен- 
ны. Мы условно разделим описание всех возможностей на несколько частей: 


1. Настройка клавиатуры. 
2. Использование "горячих" клавиш и акселераторов. 
3. Поддержка различных языков. 


Поддержка клавиатуры в операционных системах Ут9о\$ осуществляется 
независимо от типа подключенного устройства и используемого языка. Лю- 
бые нажатия клавиш (в виде скан-кодов) преобразуются системой (драйве- 
ром клавиатуры) и, в зависимости от установленного языка, отображаются 
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в окне запущенного приложения. Каждому языку соответствует свой набор 
символов, а драйвер сам выполняет все необходимые преобразования. Про- 
граммисту достаточно ознакомиться только с универсальным набором скан- 
кодов так называемых ‘виртуальных клавиш (основные из них перечислены 
в табл. 3.19). Каждая виртуальная клавиша имеет свое имя и числовое зна- 
чение. В программах следует пользоваться по возможности именами кла- 
виш, чтобы сохранить совместимость программ в дальнейшем. 


Таблица 3.19. Виртуальные клавиши 


Клавиша Имя Клавиша Имя 

Таб УК_ТАВ Риги Зсгееп УК ЗМАРЗНОТ 
Васкзрасе УК_ВАСК Эсгой Еоск УК_$СВОБЬ 
Ещег УК_ВЕТОВМ Раизе УК _РАЦЗЕ 
УНИ УК_5НТЕТ пзен УК_ТМЗЕВТ 
АК УК_МЕМО Сеее УК РЕЪЕТЕ 
Си УК_СОМТВОЬ Ноте УК_НОМЕ 
Сар$ [оск УК_САРТТАЬ Епа УК_ЕМР 

Езс УК _ЕЗСАРЕ Раде Ур УК_РВТОВ 
Зрасе УК 5РАСЕ Раде Вомп УК_МЕХТ 

Еей Атом УК ЪЕЕТ тей МИп УКВ 
Вам Агом УК_ВТСНТ Аа М/п УК_ВИТМ 

Ур Атом УК ОР Аррз УК_АРРЗ 
Бомп Аггоми УК_РОиМ Зеер УК 5ЬЕЕР 

(+) 0 УК_МОМРАОО * УК_МОБТТРЬУ 
(+) 1 УК_МОМРАР1 + УК_АРБ 

(+) 2 УК_МОМРАО2 \ УК_ЗЕРАВАТОВ. 
(+) 3 УК_МОМРАРЗ - УК_ЗОВТВАСТ 
(+) 4 УК_МОМРАРА / (деление) Ук_РТУТОЕ 
(+) 5 УК_МОМРАО5 Мит Госк УК_МОМЪОСК 
(+) 6 УК_МОМРАОВ кен ЗВ УК_Г5НТЕТ 
(+)7 УК_МОМРАР7 Вюом ЗЫ УК_ВЗНТЕТ 
(+) 8 Ук_МОМРАР8 (ен сч УК_ТСОМТВОЬ 
(+) 9 УК_МОМРАОЗ ВюнЕ Си УК_ВСОМТВОЬ 
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Таблица 3.19 (окончание) 








Клавиша Имя Клавиша Имя 
Гей АК УК _ТГМЕМО Еб УК Еб 
АаН: АК УК_ТМЕМО Е? УК Е? 
Е1 УК_Е1 Е8 УК_Е8 
Е2 УК Е? Е9 УК 59 
ЕЗ УК_ЕЗ Е10 УК_Е1О 
Е4 УК Е4 Е11 УК _Е11 
25 УК_Е5 Е12 ук 212 





Для буквенно-цифровых клавиш существуют только числовые коды, с кото- 
рыми можно ознакомиться в документации фирмы М!гсгозой. 


3.4.1. Настройка клавиатуры 


Итак, первая возможность настройки клавиатуры, которую мы рассмотрим, 
относится к установке времени задержки для автоповтора. Для этого ис- 
пользуется уже знакомая нам по гл. 2 функция ЗузЕетРахащесегТоРо с пара- 
метром зРТ ЗЕТКЕУВОАВОРЕТАУ. Второй аргумент функции должен указывать 
на время задержки. Поддерживаются четыре значения времени: 0 — 250 мс, 
| — 500 мс, 2 — 750 мс, 3 — 1000 мс. Существует также возможность полу- 
чения текущего значения времени задержки, для чего служит параметр 
ЗРТ СЕТКЕУВОАВОРЕТАУ. Пример кода, использующий обе эти возможности, 
представлен в листинге 3.24. 





Листинг 3.24. Установка и получение времени задержки 
// напишем функцию для установки времени задержки 
Боо1 ЗеЕре1ау ( 106 1Юе1ау) 
{ 
11Е 101аШе1ау = -1; 
// проверяем диапазон аргумента (полжен быть от 0 до 3) 
1Е ( ( 10е1ау < 0) &5& ( 10е]1ау > 3)) гебагр ЁЕа15е; 
// получаем текущее значение времени задержки 
ЗузсетРагащесегзТиРо ( РТ СЕТКЕУВОАВОРЕТАУ, 0, &101А0е1ау, 0); 
// если значение ошибочно или равно устанавливаемому, выходим 
1Е ( ( 101а0е1ау == -1) || ( 101аре1ау == 1Бе1ау) 
гебигп ЁЕа1зе; 
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// устанавливаем новое значение времени задержки 
ЗузсетРакамекегзТиЕо ( ЗРТ ЗЕТКЕУВОАВОРЕГАУ, 10е1ау, 0, 
ЗРТЕ ЗЕМОСНАМСЕ | ЗРТЕ ОРРАТЕТМТЕТЬЕ); 
тебагп гие; 


} 


Кроме времени задержки, существует также возможность изменения часто- 
ты автоповтора символов. Для этого следует передать в первый аргумент 
функции ЗузеетрагаметегэТоЕо Параметр ЗРТ ЗЕТКЕУВОАВОЗРЕЕО, а Во ВТо- 
рой — новое значение частоты (от 0 до 31). Установка частоты в 0 соответ- 
ствует 2,5 символам в секунду, а установка числа 31] — 30 символам в се- 
кунду. Остальные возможные значения лежат между ними (подробнее см. 
в табл. 3.7). Для получения текущего значения частоты автоповтора исполь- 
зуется параметр $Рт СЕТКЕУВОАВОЗРЕЕР. В листинге 3.25 представлен пример 
функции, устанавливающей новое значение частоты автоповтора. 





: Листинг 3.25. Установка и получение частоты автоповтора 


// напишем функцию для установки частоты автоповтора 
Боо1т ЗеёЕгеа ( 1пЕ 1Егеа) 
{ 
106 101аЕгеа —1; 
// проверяем диапазон аргумента (должен быть от 0 до 31) 
1Е ( (1Екеа < 0) && ( 1Ехеа > 31)) гебакп Еа1зе; 
// получаем текущее значение частоты 
ЗузсетРагамекетзТрЕо ( ЗРТ СЕТКЕУВОАВОЗ$РЕЕО, 0, &1019Егеа, 0); 
// если значение ошибочно или равно устанавливаемому, выходим 
1ЁЕ ( ( 101аЕгеа == -1) || ( 101аЕтеа == 1Етеа) 
хегагп Еа15е; 


И 


// устанавливаем новое значение частоты 
ЗузсемРагамекегзТтЕо ( ЗРТ ЗЕТКЕУВОАВОЗРЕЕО, 1Етеч, 0, 
ЗРТЕ ЗЕМОСНАМСЕ | ЗРТЕ ОРРАТЕТМТЕТЬЕ); 
тебагп Егае; 


} 


Как видите, настройка параметров автоповтора не представляет особых 
трудностей. Давайте теперь перейдем к еще одной удобной возможности 
управления клавиатурой. Она не имеет прямого отношения к устройству 
клавиатуры, но тесно связана с ней — это частота мигания текстового кур- 
сора. Для установки частоты мигания применяется функция зеЕСакеев11тк- 
Т1ие. Единственный аргумент функции задает промежуток времени (в мил- 
лисекундах) между двумя появлениями текстового курсора на экране. 
Существует также функция бееСагеев14ткТаме, позволяющая получить теку- 
щее значение времени мигания курсора. Следует иметь в виду, что измене- 
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ние частоты мигания курсора будет использоваться системой для всех при- 
ложений. В листинге 3.26 представлен пример функции, устанавливающей 
новое значение для частоты мигания курсора. 


Листинг 3.26. Установка частоты мигания текстового курсора ` 





// напишем функцию для установки частоты мигания курсора 
Боо1 ЗефЕкеаСагее ( 1пЕ 1Егеда) 
{ 
116 1О19Егеа = 200; 
// проверяем диапазон аргумента (должен быть от 200 до 1200) 
1Е { ( 1Ехгеа < 200) && ( 1Егеа > 1200)) гебагп Еа1зе; 
// получаем текущее значение частоты 
1О1аггеа = бесСагееВ11пкТ1те (); 
// если значение равно устанавливаемому, выходим 
1Е ( 101аЕкеа == 1Еткеа) 
гесигп Еа15е; 
// устанавливаем новое значение частоты 
1Е ( '!ЗесСагеевВ11лКкТ1ме ( 1Етеа)) 
тефагп Га1зе; // произошла ошибка 
тебагп $тгае; 


} 


При успешном завершении функция зееСагеев11окТие должна возвратить 
ненулевое значение. Если функция вернула 0, значит, произошла ошибка, 
расширенное описание которой можно получить через вызов беетазЕЕггог. 
То же самое относится и к функции сеЕСахеев11ткТ1ие. 


Существует возможность программного отключения клавиатуры. Для этого 
применяется функция взосктпрае, подробно рассмотренная в га. 2. 


3.4.2. Использование "горячих" клавиш 


Очень удобной возможностью работы в УМ4о\з является использование 
оперативных и "горячих" клавиш. Под оперативными клавишами понимают 
комбинации клавиш для быстрого доступа к различным командам меню. Их 
еще называют акселераторными клавишами. Удобство их заключается в 
том, что к ним можно обращаться, когда меню закрыто и не активно. Рабо- 
тать с акселераторами достаточно просто. Вначале, используя редактор ре- 
сурсов, следует добавить в свою программу ресурс акселератора, присвоить 
ему идентификатор (например, му АССЕТ) и назначить комбинации клавиш. 
Далее следует открыть в этом же редакторе ресурс меню и добавить к же- 
лаемым пунктам описание закрепленной за ним клавиши (например, 
"зОткрыть \Е СЕг1+0"). После этого добавляем в стандартный код окна опи- 
сание акселераторов, как показано в листинге 3.27. 
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‚Листинг 3. 27. Добавление поддержки акселераторов | в программу 


// в функцию И10Малп добавляем следующий код 
И! 
// загружаем таблицу акселераторов с идентификатором МУ АССЕБ 
НАССЕГ ПАссе]1 = ТоадАссе1егабогз ( ПТпз®е, МАКЕТМТВЕЗООВСЕ ( МУ АССЕТ)); 
// 
// добавляем в цикл обработки сообщений перехватчик акселераторных клавиш 
\21]е ( СефМеззаде ( &иза, МО, 0, 0)) 
{ 
1Е ( 'Тгарз1абеАссе1ега®ог ( В\па, РАссе!, &154а)) 
{ 
Тгапз1атеМеззаде ( &т549); 
03 зраесЬМеззаде ( &13$9); 


Как видно из кода, для загрузки таблицы акселераторов используется функ- 
ЦИЯ ТоадАссе1егакогз. Данная функция имеет два аргумента. Первый аргу- 
мент указывает на дескриптор приложения, а второй определяет имя ресур- 
са для таблицы акселераторов. Можно вместо имени использовать иденти- 
фикатор, обработав его макросом макхктмтвеЕЗООВСЕ. После загрузки таблицы 
акселераторов необходимо установить перехватчик для всех оперативных 
клавиш. Роль перехватчика выполняет функция Тгапз1аеАссе1екафог. Пер- 
вый аргумент функции указывает на дескриптор главного окна программы. 
Второй аргумент должен хранить дескриптор таблицы акселераторов (тип 
НАССЕТ,). Третий аргумент указывает на структуру мзс. Вот и все сложности. 
Теперь выбор назначенной для пункта меню комбинации клавиш (напри- 
мер, <Си1>-+<О>) вызовет выполнение соответствующей команды. 





К сожалению, у акселераторов есть один существенный недостаток. Вы не 
сможете их использовать, если приложение потеряло фокус. Операционная 
система \Мтао\5 автоматически выбирает таблицу акселераторов только для 
активного окна. Решить эту проблему можно с помощью "горячих" клавиш. 
Они представляют собой такую же комбинацию клавиш, как и акселерато- 
ры, но имеют в системе глобальный статус. Независимо от того, какая про- 
грамма активна в данный момент, можно вызывать различные команды по- 
средством "горячих" клавиш. Согласитесь, это очень удобно: ваша програм- 
ма может "сидеть" в системном трее или вообше быть невидимой, но стоит 
на клавиатуре набрать заветную комбинацию, и любая назначенная вами 
команда будет исполнена. Прежде чем рассказать, как программируются 
"горячие" клавиши, хочу выделить два важных правила: 


1. Каждая "горячая" клавиша регистрируется в системе отдельно и должна 
иметь уникальный глобальный идентификатор. 
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2. После завершения работы с программой необходимо удалить зарегистри- 
рованные "горячие" клавиши из системы. 


Для регистрации "горячей" клавиши используется функция Вед1зеегНосКеу. 
Функция имеет четыре аргумента. Первый указывает на дескриптор окна, 
которое будет обрабатывать специальное сообщение им ноткЕу. Второй ар- 
гумент указывает на идентификатор "горячей" клавиши, который назначает- 
ся разработчиком. Это значение должно лежать в определенных пределах: 
для обычной программы — от 0х0000 до ОхвЕЕЕ, для библиотеки ОМ, — 
ОТ 0хС000 ДО ‘ОхЕЕЕЕ. Чтобы избежать конфликтов с другими аналогичными 
значениями, для библиотек ОШ. следует использовать функцию с1оъа1Ааа- 
АбБот. Третий аргумент функции определяет модификатор для комбинации 
клавиш. Возможные значения для этого аргумента приведены в табл. 3.20. 
Можно комбинировать модификаторы` между собой. 


Таблица 3.20. Типы модификатора клавиш 





Константа Описание 


МОР_5НТЕТ Необходимо удерживать любую клавишу <ЗЫЙ> на клавиатуре 
мор сомтвоь — Необходимо удерживать любую клавишу <С\> на клавиатуре 
МОР_АГТ Необходимо удерживать любую клавишу <АК> на клавиатуре 


МОР_ЯТМ Необходимо удерживать любую клавишу <\\Мп> на клавиатуре 


Четвертый аргумент функции задает код виртуальной клавиши (см. табл. 3.19). 
При успешном выполнении функции будет возврашено ненулевое значение. 
Если комбинация клавиш уже была зарегистрирована в системе другой про- 
граммой, функция возвратит ошибку. В некоторых системах (например, 
в \ш4до\5 2000) клавиша <Е12> занята системой и ее не стоит использовать 
в качестве "горячей" клавиши. После регистрации всех необходимых про- 
грамме "горячих" клавиш нужно добавить в функцию главного окна про- 
граммы обработчик сообщения им ноткЕУ. В нем будет сосредоточена вся 
работа по обработке зарегистрированных клавиш. После завершения работы 
с программой следует для каждой "горячей" клавиши вызвать функцию оп- 
гед1зеегНоЕКеу, Которая удалит регистрацию клавиши из системы. Чтобы 
закрепить полученные сведения, изучите листинг 3.28. 


Листинг 3.28. Использование "горячих" клавиш в программе | 


// в начале файла описываем свои клавиши 
#+АеЕ1пе МУ НОТ КЕУ 1 ИМ ОЗЕВ + 5001 
+АеЁ1пе Му НОТ КЕУ 2 ИМ ОЗЕВ + 5002 
+$+ЧеЁ1пе МУ НОТ КЕУ 3 ММ О5ЕВ + 5003 
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// в главную функцию окна добавляем поддержку клавиш 
ТВЕЗОШТ САШ.ВАСК МуУМа1тРгос ( НММО Б\па, ОТ\МТ пеззасе, 
О]МТ и"Рагам, ТОМС 1Рагам) 


зи1ЕсЬ ( шеззаде) 
{ 
сазе ИМ СВЕАТЕ: // во время создания окна регистрируем клавиши 
// пля первой клавиши назначаем комбинацию СЕг1+Е2 
ВедузтегНоеКеу ( Б\па, Му НОТ КЕУ 1, МОБ СОМТВОЬ, УК_Е2); 
/7 для второй клавиши назначаем Ноте 
Вед1зтегНосКеу ( Ю\па, Му НОТ КЕУ 2, МОБ, УК _НОМЕ); 
// для третьей клавиши назначаем комбинацию СЕг1+561ЕЕ+Е5 
Вед1зкегНоеКеу ( В\па, МУ НОТ КЕУ 3, МОР СОМТВОГ | МОБ $НТЕТ, 
УК _Е5); 
Ргеак; 
сазе ИМ НОТКЕУ: // обработка "горячих" клавиш 
{ 
зи1ЕСсВ ( мРагам) // чРагам содержит идентификатор 
{ 
сазе Му НОТ КЕУ 1: 
// выполняем какую-либо свою команду 
ргеак; 
сазе МУ НОТ КЕУ_2: 
// выполняем какую-либо свою команду 
ргеак; 
сазе Му НОТ КБУ 3: 
// выполняем какую-либо свою команду 
Ргеак; 


} 

ргеак; 
сазе ММ РЕЗТВОУ: // завершаем программу 
// удаляем регистрацию клавиш 
Оптед1зсегНосКеу ( 0, МУ НОТ КЕУ 1); 
Опгед1зсегНоеКеу ( 0, МУ НОТ КЕУ_2); 
ОпгедазтегНоеКеу ( 0, МУ НОТ КЕУ 3); 

Ргеак; 
ЧеЁаи1*: 

гесагп ( ОеЁМ1пЧомРгос ( Б\№Па, пеззаде, м"Рагам, 1Рагап)); 
} 

тебагп (0); 


} 
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3.4.3. Поддержка языков 


Как правило, на обычном компьютере устанавливается поддержка не только 
русского, но и английского (или любого другого) или нескольких языков. 
Для переключения между ними применяется предопределенная комбинация 
клавиш. Мы можем из программы управлять выбором того или иного язы- 
ка. За каждым поддерживаемым языком закреплен идентификационный 
номер. Для загрузки нового языка применяется функция ТоааКеубоагаЪауой*. 
Первый аргумент функции указывает на идентификатор языка (строка с 
шестнадцатеричным значением), который следует загрузить. Например, для 
английского языка идентификационный номер равен 0х0409, где младшее 
слово указывает на идентификатор языка, а старшее — на дескриптор уст- 
ройства (драйвера поддержки языка). В функцию записывается строковое 
значение "00000409". Для русского языка идентификационный номер будет 
равен "00000419" (0х0419). Второй аргумент функции определяет допол- 
нительный флаг, который может принимать одно из перечисленных в 
табл. 3.21 значений. 


Таблица 3.21. Значение флага для раскладки клавиатуры 


Значение флага Описание 


КЬЕ_ВЕОВРЕК Передвигает раскладку данного языка на первое место в списке 


КЬЕ_ВЕРЬАСЕГАМС Если указанный идентификатор совпадает с уже имеющимся, 
то он все равно заменяет последний 





ЪЕ_АСТТУАТЕ Делает активной загруженную раскладку языка 


х 


При успешном выполнении функция возвратит идентификатор (тип нкг) 
загруженного языка. Для того чтобы выгрузить какой-либо язык, следует 
использовать функцию 0п1оаЧКеуБоахЬауоче. Она имеет только один аргу- 
мент, указывающий на идентификатор языка. При успешном выполнении 
функция возвратит ненулевое значение. Дополнительно к описанным 
функциям можно применять Асе1уасеКеуроагаЪауоте для выбора текущего 
языка. Функция содержит два аргумента. Первый указывает на идентифика- 
тор языка, но может также принимать одно из следующих значений: 
НКЬ МЕХТ — выбрать следующий язык из списка, нкь РВЕУ — выбрать преды- 
дущий язык из списка. Второй аргумент определяет флаг операции. Это 
может быть одно из следующих значений: ктЕ ВЕОВРЕВ — переопределить 
список с учетом выбранного, кьг ВЕЗЕТ — сбросить блокировку использова- 
ния заглавных букв (только для Упдо\з 2000), къЕ 5НТЕТТОСК — ВКЛЮЧИТЬ 
блокировку использования заглавных букв (только для УЛп4о\з 2000). 
В листинге 3.29 приведен пример работы с рассмотренными функциями. 
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// загружаем русскую раскладку клавиатуры 

НКЬ ВВиз = ТоааКеуроагаТауойе ( "00000419", КЬЕ ВЕОВБЕВ); 
// делаем русский язык текущим 

ЛЕ ( ВВаз != МОШ) 

Асс 1уафеКеуроагЧТауойс® ( ЪВиа5, КЬЕ ВЕОВОЕВ); 

// после работы с русской раскладкой, выгружаем ее 
Оп1оаЯКеуроагаФауояде ( №Виз); 


Существует также возможность получения информации о текущей расклад- 
ке клавиатуры. Для этого используются функции сееКеуроагатауойе И бех- 
КеуроагЧТауоцЕМаце. Первая функция возвращает числовой идентификатор 
(тип нкь) текущего языка, а вторая — строку с именем раскладки (напри- 
мер, "00000419"). 


На этом мне бы хотелось завершить описание различных способов про- 
граммирования клавиатуры и перейти к рассмотрению не менее важного 
элемента любого компьютера — видеоадаптера. 


ГЛАВА 4 


Видеоадаптер 


Видеоадаптер является, пожалуй, одним из самых интересных устройств, 
входящих в состав современного компьютера. В тандеме с монитором он 
позволяет проникнуть в совершенно другой, виртуальный мир, расцвечен- 
ный невообразимыми красками и эффектами. Он служит своеобразным 
мостом между бездушными железками и ожившими образами. Вряд ли 
компьютер получил бы такое широкое признание людей, далеких от техни- 
ки, если бы не его способность приоткрывать дверь в другой, так не похо- 
жий на наш, мир. 


Это небольшое отступления я сделал не для того, чтобы повторить простые 
истины, но показать, насколько большое значение имеет видеоадаптер и 
монитор в общении простого пользователя с компьютером. Из сказанного 
выше разработчик программного обеспечения должен сделать один главный 
вывод: необходимо знать и уметь программировать возможности видеоадап- 
тера и монитора. Не стоит всецело полагаться на готовый визуальный ин- 
терфейс УИпдо\$ или библиотеку Оес(Х, многие задачи (например, созда- 
ние динамичных игрушек) потребуют более широких знаний и умений ра- 
ботать с оборудованием. 


В этой главе мы рассмотрим различные возможности доступа к видеоадап- 
теру (видеоконтроллеру), которые можно представить в виде списка: 


1. Использование функций В1О$ через прерывание 1пЕ 10ъ. 
2. Использование аппаратных портов. 


3. Использование возможностей \!т32 АР[. 


4.1. Общие сведения 


Стандарты видеоадаптеров имеют достаточно большую историю. Первые 
монохромные адаптеры появились в начале 80-х годов прошлого века. Они 
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поддерживали только два цвета (обычно зеленый на черном фоне) и работа- 
ли исключительно в текстовом режиме. В этом режиме на экран монитора с 
разрешением 80х25 (столбцов хстрок) выводился стандартного размера 
прямоугольник (14 на 9 пикселов) с определенным символом. Далее по- 
явился новый стандарт — ССА (Со]ог ОтарН!с$ Адарег), позволяющий ра- 
ботать как в текстовом, так и в графическом режиме. В последнем режиме 
он поддерживал два разрешения: 320х200 (4 цвета) и 640х200 (2 цвета) 
пикселов. Были и другие стандарты (НСС, ЕСА), давно устаревшие и не 
используемые в современных видеоадаптерах. 


Сегодня применяются современные УСА-совместимые (\У!ео СтарНс$ 
Агтау) видеоадаптеры, которые поддерживают большое количество тексто- 
вых и графических режимов: 4 текстовых, 256-иветный, Н!Со]ог (65 536 цве- 
тов) и ТшеСо]ог (минимум 16,7 млн цветов). Для унификации управления 
режимами видеоадаптеров был разработан общий стандарт УВЕ (УЕЗА В1О0$ 
ЕХТЕМЗ ОМ). Он позволил определить одинаковые способы доступа к ос- 
новным функциям многочисленных графических адаптеров различных фирм. 
Базируясь на наборе функций В10$, использующих прерывание 12е 10%, он 
может применяться для программирования любых УВЕ-совместимых видео- 
адаптеров. Прежде чем рассмотреть возможности этого стандарта, хочу ска- 
зать два слова о видеопамяти. Каждый видеоадаптер содержит определен- 
ный объем памяти, который применяется для промежуточного хранения 
данных, поступающих от компьютера. От размера видеопамяти напрямую 
зависят возможности самого адаптера: поддерживаемое разрешение и ско- 
рость работы. Существует простая формула, позволяющая подсчитать необ- 
ходимый размер памяти для работы в том или ином разрешении. Для этого 
нужно перемножить значения разрешения по вертикали и горизонтали и 
умножить результат на количество байт в одном пикселе (16,7 млн — 
3 байта, 65 536 — 2 байта, 256 — 1 байт). Например, для поддержки разре- 
шения 1024 х 768 х 16 размер памяти должен быть как минимум 2 Мбайт. 
А теперь непосредственно приступим к изучению набора функций В1О$ для 
программирования видеоадаптеров. 


4.2. Использование функций ВЮ$ 


Существует два набора функций ВОЗ: для работы с УСА и $ирег УСА ре- 
жимами. Большинство режимов УСА устарели, но для полноты информа- 
ции приведу список основных режимов в табл. 4.1. Кроме них, существует 
еще много других режимов, поддерживаемых производителями видеокон- 
троллеров. 


Для поддержки работы с видеоадаптером дополнительно в системной памя- 
ти (в первом мегабайте) выделяется окно определенного размера. Для тек- 
стовых режимов размер окна равен 32 Кбайт, а диапазон адресов — в80005— 
ВТЕЕЕВ (за исключением режимов 04в и 051). Для графических режимов раз- 
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мер окна составляет 64 Кбайт, а диапазон — А00005—АЕКЕЕЬ. Именно через 
это окно происходит запись данных в память видеоадаптера. При работе в 
текстовом режиме каждому символу в памяти выделяется 2 байта: первый 
хранит АЗСП-код символа, а второй — атрибуты символа (см. табл. 4.2). 
Для чего нужен байт атрибутов, вы узнаете дальше, по ходу изучения функ- 
ций ВГОЗ. 


Таблица 4.1. Основные режимы УСА 


Код Разрешение Количество цветов Число страниц 
00и 40х25 (текстовый} 16 8 
018 40х25 (текстовый) 16 8 
02 80 х25 (текстовый) 16 8 
ОЗ 80х25 (текстовый) 16 8 
04 320 х 200 (графический) 4 4 
05 320 х 200 (графический) 4 4 
оби 640х200 (графический) 2 2 
078 80х25 (текстовый) 2 _ 
ов 320 х 200 (графический) 16 8 
СЕВ 640х200 (графический) 16 4 
ЕВ 640 х350 (графический) 2 2 
108 640 х 350 (графический) 16 — 
И 640 х 480 (графический) 2 _ 
128 640х480 (графический) 16 — 
13 320 х 200 256 _ 


4.2.1. Функция О0Р 


Эта функция позволяет установить текстовый или графический режим. Как 
правило, эту функцию следует вызывать в самом начале программы, неза- 
висимо от текущего режима. Если в программе использовался графический 
режим, желательно перед ее завершением переключиться в текстовый. 
Использование: 

1. В регистр Ан следует поместить код функции о0в. 

2. В регистр Аь нужно записать код режима (см. табл. 4.1). 


3. Вызвать прерывание 1п+ 10н. 
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Выход: 


После выполнения функции некоторые В1О$ (например, АМГ В1О5) запи- 
шут в регистр Ат, определенное значение: 


С 20ъ — код установленного режима больше 058: 


С зов — код установленного режима лежит в диапазоне ов—5ъ или ра- 
вен 07н; 


О зв — код режима равен 065. 


С помощью данной функции можно очистить экран дисплея. Пример уста- 
'овки текстового режима показан в листинге 4.1. 


Листинг 4.1. Использование функции 005 


пох АН, 00% ; код функции 00% 


пох А, 1 ; текстовый режим 40 х 25 х 16 
106 105 ; вызываем прерывание 
стр Ат, 308 ; проверяем значение для АМТ ВТО$ 


пе Еггог Моде; вызываем обработчик, если режим не установлен 


4.2.2. Функция 01В 


Функция позволяет установить размер курсора для текстовых режимов ра- 
боты видеоадаптера. Курсор служит удобным указателем точки ввода на эк- 
ране дисплея. Его размер может варьироваться от линии до полного размера 
прямоугольника, отведенного под один символ. Курсор состоит из горизон- 
тальных линий. ` 


Использование: 

1. В регистр Ан следует поместить код функции о1ь. 

2. В регистр сн нужно записать начальную линию, начиная сверху. Для 
хранения значения линии используются только биты с 0 по 4. Некоторые 
ВО$ могут поддерживать дополнительно установку общего вида курсора. 
При этом бит 7 должен быть установлен в 0, а биты 5 и 6 — в одно из 
следующих значений: 00» — обычный вид, 01.— невидимый. Еще раз 
повторю, что установка битов 5 и 6 работает не на всех системах, поэто- 
му желательно биты 5, би 7 устанавливать в 0. 


3. В регистр съ нужно записать конечную линию. 
4. Вызвать прерывание пе 10Ъ. 


Выход: 


Возвращаемого значения нет. Рассмотрим простой пример установки раз- 
мера курсора, состоящего из 10 линий (листинг 4.2). 
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: Листинг 4.2. Использование функции 01% 


; код функции 018 

; номер начальной линии, начиная сверху экрана 
поу СЬ, ОАВ ; номер конечной линии равен 10 

11 108 ; вызываем прерывание 


4.2.3. Функция 025 


Данная функция позволяет установить текущую позицию курсора на экране 
дисплея. Отсчет координат производится с левого верхнего угла (0, 0). Кро- 
ме того, следует учитывать номер текущей страницы видеопамяти, который 
может меняться для различных режимов от 0 до 8. Каждая' страница содер- 
жит свой курсор, поэтому при переключении страниц установку позиции 
курсора необходимо выполнять заново. Если используется монохромный 
дисплей (бывает и такое), номер страницы памяти всегда должен быть ра- 


вен 0. Номер страницы следует устанавливать в 0 и при работе в графиче- 
ских режимах. 


Использование: 

В регистр Ан следует поместить код функции 025. 

В регистр вн нужно записать номер страницы. 

В регистр рн нужно записать номер строки (от оо). 
В регистр от, нужно записать номер столбца (от обв). 


пов - 


Вызвать прерывание зп 108. 


Выход: 


Возвращаемого значения нет. Рассмотрим простой пример установки пози- 
ции курсора на 2-ю строку 27-го столбца в листинге 4.3. 


оу АН, 026 $; код функции 026 


оу ВН, 0 ; номер страницы 

пох ОН, 2 ; номер строки 

поу ОБЬ, 27 ; номер столбца 

106 108 ; вызываем прерывание 


Данная функция также позволяет скрыть курсор с экрана дисплея. Для это- 
го достаточно установить значение номера строки на единицу больше, чем 
максимальное разрешение по вертикали (для текстовых режимов 25). Не 
забудьте, что отсчет ведется с 0. Пример кода, позволяющий убрать курсор 
с экрана дисплея, будет выглядеть так, как показано в листинге 4.4. 
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поу АН, 025 ; код функции 026 


поу ВН, 0 ; номер страницы 

шоу ОН, 25 ; номер строки 

пох БЬ, 0 ; номер столбца 

11Е 108 ; вызываем прерывание 


4.2.4. Функция ОЗВ 


Данная функция позволяет получить размер и позицию курсора для указан- 
ной страницы видеопамяти. 


Использование: 

1. В регистр Ан следует поместить код функции озь. 

2. В регистр вн нужно записать номер страницы видеопамяти (от 0 до 7). 
3. Вызвать прерывание 1пе 101. 


Выход: 


После выполнения функции интересующая нас информация будет распре- 
делена следующим образом: 


О регистр ах — значение о000н (только для Рпоешх В1О5); 
О регистр сн — номер начальной линии курсора; 

О регистр съ — номер конечной линии курсора; 

О регистр он — номер строки позиции курсора; 

О регистр от, — номер столбца позиции курсора. 


Пример кода, позволяющий определить позицию для текущего курсора, 
представлен в листинге 4.5. 


пох АН, ОЗН ; код функции 038 
оу ВН, 0 ; номер страницы 

106 108 ; вызываем прерывание 
; получаем позицию курсора 

моу СОВ У, ОН; номер строки 

поу СОВ_Х, БЬ; номер столбца 


4.2.5. Функция 05 


Функция позволяет выбрать текущую страницу видеопамяти для текстового 
режима. Диапазон возможных значений лежит от ов до 07п. 
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Использование: 
1. В регистр дн следует поместить код функции 056. 


2. В регистр Ат нужно записать номер страницы видеопамяти. 
3. Вызвать прерывание 154 108. 


Выход: 


Возврашаемого значения нет. Рассмотрим простой пример, в котором выбе- 
рем текущую страницу под номером 2 (листинг 4.6). 


: Листинг 4.6. Использование функции 058 


поу АН, 051 ›; код функции 058 
поу ВН, 01. ; вторая страница видеопамяти 
11 108 ; вызываем прерывание 


4.2.6. Функция 06Р 


Эта функция позволяет прокрутить активную страницу вверх. Перед вызо- 
вом данной функции рекомендуется установить номер активной страницы с 
помошью предыдушей функции о5н. 


Использование: 
1. В регистр дн следует поместить код функции о6ь. 


2. В регистр Аь нужно записать число строк, на которое будет выполнена 
прокрутка. Если установить значение оон, указанная часть страницы бу- 
дет полностью очищена. 


В регистр вн нужно записать значение байта атрибутов. 
В регистр сн следует поместить номер строки верхнего левого угла окна. 
В регистр ст следует поместить номер столбца верхнего левого угла окна. 


В регистр он следует поместить номер строки нижнего правого угла окна. 


В регистр рь следует поместить номер столбца нижнего правого угла 
окна. 


8. Вызвать прерывание 1пе 108. 


Выход: 


Возврашаемого значения нет. Данную функцию можно с успехом использо- 
вать для очистки всего или части экрана. Формат байта атрибутов показан 
в табл. 4.2. Например, чтобы прокрутить экран вверх на 3 строки, следует 
написать код, показанный в листинге 4.7. 
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Бит 


чо а.о ъ 


055 ; код функции 058 
00н ; выбираем первую страницу 
; вызываем прерывание 
06р ; код функции 066 
ОЗВ ; число строк 
11 ; атрибут очистки 
0 ; номер строки верхнего угла 
0 ; номер столбца верхнего угла 
24 ; номер строки нижнего угла 
79 ; номер столбца нижнего угла 
; вызываем прерывание 
Таблица 4.2. Формат байта атрибутов 
Описание 


Использование синего в основном цвете (1 — использовать) 


Использование зеленого в основном цвете (1 — использовать) 


Использование красного в основном цвете (1 — использовать} 


Повышенная насыщенность (1 — использовать) 


Использование синего в фоновом цвете (1 — использовать) 


Использование зеленого в фоновом цвете (1 — использовать) 


Использование красного в фоновом цвете (1 — использовать) 


Использовать мигание 


Код, позволяющий очистить экран, представлен в листинге 4.8. 





поУу 
поУ 
поУ 
поУ 
поУ 
оу 
оу 
106 


АН, 


ину 





068 
оов 


Листинг 4. 8. Использование функции Обь "длЯ < очистки и экрана 


Й 





код функции 060 

число строк обнуляем 
атрибут очистки 

номер строки верхнего угла 
номер столбца верхнего угла 
номер строки нижнего угла 
номер столбца нижнего угла 


вызываем прерывание для очистки окна 
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4.2.7. Функция 07В 


Функция позволяет прокрутить активную страницу вниз. Перед вызовом 
данной функции рекомендуется установить номер активной страницы с по- 
мощью предыдущей функции о5ъ. 


Использование: 
1. В регистр Ан следует поместить код функции о7в. 


2. В регистр АЬ нужно записать число строк, на которое будет выполнена 
прокрутка. Если установить значение 00ь, указанная часть страницы бу- 
дет полностью очищена. 


.В регистр вн нужно записать значение байта атрибутов (см. табл. 4.2). 
В регистр сн следует поместить номер строки верхнего левого угла окна. 
В регистр съ следует поместить номер столбца верхнего левого угла окна. 


В регистр рн следует поместить номер строки нижнего правого угла окна. 


ми > 


В регистр оъ, следует поместить номер столбца нижнего правого угла 
окна. 


8. Вызвать прерывание 1пе 108. 


Выход: 


Возвращаемого значения нет. Данную функцию можно с успехом использо- 
вать для очистки всего или части экрана. Например, чтобы прокрутить эк- 
ран вниз на 4 строки, следует написать код, как в листинге 4.9. 





Листинг 4.9. Использование функции 07 


поУу АН, 05 ; код функции 056 
поу ВН, Обь ; выбираем первую страницу 


116 108 ; вызываем прерывание 

поу АН, 07Н ; код функции 078 

поу АБ, 04В ; число строк 

оу ВН, 7 ; атрибут очистки 

пох СН, 0 ; номер строки верхнего угла 
шоу СГ, 0 ; номер столбца верхнего угла 
оу ОН, 24 ; номер строки нижнего угла 
поу СГ, 79 ; номер столбца нижнего угла 
116 108 ; вызываем прерывание 


Как видите, функция 075 аналогична о06ь и также может использоваться для 
очистки экрана или сдвига экрана в сторону. 
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4.2.8. Функция 08В 


Данная функция предназначена для чтения символа и его атрибутов для 
текущей позиции курсора. 

Использование: 

1. В регистр Ан следует поместить код функции о8ь. 


2. В регистр вн нужно записать номер страницы. 


3. Вызвать прерывание 11+ 108. 


Выход: 


После выполнения функции в регистр дн будет записан атрибут символа, а 
в регистр АБ — код символа. Атрибут символа (см. табл. 4.2) характеризует 
следующие свойства: ивет фона (биты 4—6), цвет символа (биты 0—2), на- 
сыщенность (бит 3) и мигание (бит 7). Возможные значения цвета символа 
представлены в табл. 4.3. 


Таблица 4.3. Набор значений цвета для символов 









Значения битов цвета (0—2) Насыщенность (бит 3) 


З ый Красный 
ит 









Выключена (0) 














0 0 Серый Черный 
0 Светло-синий Синий 
0 Светло-зеленый Зеленый 
0 Светлый циан Циан 
1 Светло-красный Красный 
1 Светло-фиолетовый Фиолетовый 
1 Желтый Коричневый 
1 Белый Грязно-белый 


Возможные значения цвета для фона имеют такие же значения, но для би- 
тов 4—6. Кроме того, бит 7, а не 3 определяет насыщенность для цветовых 
комбинаций фона. Небольшой пример кода для получения атрибутов сим- 


вола показан в листинге 4.10. 





Листинг 4.10. Использование функции 085 





; установим прежде позицию курсора 
поУу АН, 028 ; функция 026 
оу ВН, 008 ; номер страницы 
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ПОХ 
ПОМ 
аа 
ПОМ 


ОН, 5 ; 
ОГ, 33 ; 


106 ; 
СН АТВ, АН; 
АН, 011115; 
СН СЬВ, АН; 





›АН, 14 ; 


Егког СТВ ; 
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номер строки 

номер столбца 

вызываем прерывание 

код функции 088 

выбираем первую страницу 

читаем атрибуты символа для текущей позиции курсора 
сохраняем атрибуты символа в переменной СН АТВ 
выделяем значение цвета символа 

сохраняем значение цвета, если нужно 
можем проверить наличие желтого цвета у символа 
цвет символа не желтый 


4.2.9. Функция ОЭП 


Данная функция предназначена для записи символа с указанными атрибу- 
тами в текущую позицию курсора. 


Использование: 
1. В регистр Ан следует поместить код функции о9в. 


2 
3. 
4 


. В регистр Аь нужно записать символ. 
В регистр вн следует поместить номер страницы. 


. В регистр вт нужно записать байт атрибутов для символа. В графическом 


режиме сюда необходимо записать значение цвета. 


5. 
6. 


Выход: 


В регистр сх нужно поместить число повторений для записи символа. 
Вызвать прерывание 1пе 101. 


Возвращаемого значения нет. С помощью этой функции можно также очи- 


стить экран дисплея в текстовом режиме 


. Пример использования функции 


09 представлен в листинге 4.11. 


; установим прежде позицию курсора 


оу 
ОУ 
оу 
поу 
пе 
по 
поУ 
поУ 


028 ; 
00 ; 
1 ; 


АН, 
ВН, 
рн, 
Оь, 
108 ; 
АН, 
АЬ, 
ВН, 


функция 028 

номер страницы 
номер строки 

номер столбца 
вызываем прерывание 
код функции 09Б 
указываем символ, который нужно записать 


номер страницы 
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шоу ВЬ, 14 ; желтый цвет символа 
пох СХ, 5 ; повторить 5 раз 
10Е 106 ; вызываем прерывание 


Для очистки экрана в текстовом. режиме можно использовать код, показан- 
ный в листинге 4.12. 


: Листинг 4.12. Использование функции 09Ъ для очистки экрана 


поу АН, 025 ›; функция 025 
оу ВН, ООр ; номер страницы 
хог ОХ, ОХ ; верхний левый угол окна (0, 0) 


116 106 ; вызываем прерывание 

по\у АН, 9 ; код функции 096 

шоу АБ, '' ; указываем символ пробела 
поу ВН, 005 $; номер страницы 

оу ВЫ, 0 ; байт атрибутов 

шоу СХ, 2000 ; число повторов (80 * 25) 
1пЕ 108 ; вызываем прерывание 


4.2.10. Функция ОАР 


Данная функция предназначена для записи символа в текушую позицию 
курсора. Отличается от функции оэь отсутствием установки байта атрибута. 


Использование: 
В регистр дн следует поместить код функции одк. 


В регистр аъ нужно записать символ. 


1 

2 

3. В регистр вн следует поместить номер страницы. 

4. В регистр сх нужно поместить число повторений для записи символа. 
5 


Вызвать прерывание 1п+ 10ь. 


Выход: 


Возвращаемого значения нет. Поскольку функция практически ничем не 
отличается от оэн, пример приводить не буду. 


4.2.11. Функция ОВР 


Данная функция имеет несколько подфункций, выполняющих различные 
операции. Рассмотрим их подробнее. 


4.2.11.1. Подфункция ООВ 


Подфункция предназначена для установки цвета обрамляющей экран рамки 
в текстовом режиме и цвета фона в графическом режиме. 
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Использование: 
1. В регистр Ан следует поместить код функции овь. 


2. В регистр вн следует поместить код подфункции 00в. 

3. В регистр въ нужно поместить значение цвета (от 0 до 15). 
4. Вызвать прерывание 1пе 101. 

Выход: 


Возвращаемого значения нет. Пример кода, позволяющий в режиме о4ь 
(см. табл. 4.1) установить желтый фон, показан в листинге 4.13. 





Листинг 4.13. Использование функции ОвО0ъ 


поу АН, 0 ; установим новый режим 

поу АБ, 04р ; графический режим 046 

ое 108 ; вызываем прерывание 

поу АН, ОВЬ ; код функции ОВЬ 

поу ВН, ООН ; код подфункции 008 

шоу ВЬ, 14 ; установим желтый цвет фона 
11 108 ; вызываем прерывание 


4.2.11.2. Подфункция 01Н 


Эта подфункция позволяет установить текущую палитру для о4н или 056 
режимов. Палитра устанавливает три основных цвета для отображаемых 
символов. Переключение с одной палитры на другую позволяет быстро из- 
менить используемые цвета. 

Использование: 

1. В регистр Ан следует поместить код функции овь. 


2. В регистр вн следует поместить код подфункции о1в. 


3. В регистр вь нужно поместить значение код палитры. Код палитры мо- 
жет иметь одно из двух значений: 00ь (зеленый, красный, коричне- 
вый/желтый) или о1в (циан, фиолетовый, белый). 


4. Вызвать прерывание 11% 101. 
Выход: 


Возвращаемого значения нет. Чтобы установить палитру для графического 
режима, можно использовать код, представленный в листинге 4.14. 





Листинг 4.14. Использование функции 08016 
шоу АН, 0 ; установим новый режим 
шоу АБ, 046 ; режим 046 
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пе 106 ; вызываем прерывание 

поУу АН, ОВЬ ; код функции ОВЬ 

поу ВН, 006 ; код подфункции 018 

поу ВЬ, 00р ; установим палитру с кодом 008 
лое 108 ; вызываем прерывание 


4.2.12. Функция ОСВ 


Функция позволяет вывести на экран дисплея один пиксел. Данную функ- 
цию следует использовать только в графических режимах. 


Использование: 
1. В регистр дн следует поместить код функции ось. 


2. В регистр Аь следует поместить значение ивета для пиксела. Если бит 7 
установить в 1, будет выполнено преобразование хов (исключающее 
ИЛИ) над устанавливаемым цветом и текущим. 


3. В регистр сх нужно поместить номер столбца. 
4. В регистр ох требуется записать номер строки. 
5. Вызвать прерывание зп 108. 

Выход: 


Возвращаемого значения нет. Пример кода, позволяющий вывести на экран 
желтую точку, показан в листинге 4.15. 


Листинг 4.15. Использование функции ось 


поу АН, 0 ; установим новый режим 

оу АБ, 04Н ; графический режим 046, 320 х 200 
ЛоЕ 108 ; вызываем прерывание 

поу АН, ОСЬ ; код функции ОСЬ 

поу АБ, 14 ; установим желтый цвет 


моУу СХ, 190 ; столбец 190 
поу ОХ, 150 ; строка 150 
116 106 ; вызываем прерывание 


4.2.13. Функция ОБР 


Данная функция позволяет прочитать с экрана дисплея один пиксел. Дан- 
ную функцию следует использовать только в графических режимах. 


Использование: 
1. В регистр дн следует поместить код функции 005. 


2. В регистр сх нужно поместить номер столбца. 
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3. В регистр ох требуется записать номер строки. 
4. Вызвать прерывание 1пе 105. 
Выход: 


После выполнения функции регистр АЪ будет содержать требуемый пиксел. 
Пример работы с данной функцией представлен в листинге 4.16. 





: Листинг 4.16. Использование функции орь 





поу АН, 0 ; установим новый режим 
поу АЬ, 04В ; графический режим О4Б, 320 х 200 
11 108 ; вызываем прерывание 


поу АН, ООВ ; код функции 008 

поу СХ, 174 ; столбец 174 

поу ОХ, 100 ; строка 100 

106 106 ; вызываем прерывание 

поу РХ_1, АБ ; сохраняем значение пиксела в переменной РХ_1 


4.2.14. Функция ОЕР 


Функция позволяет выводить символы на экран дисплея в режиме телетай- 
па. Эту функцию удобно использовать для вывода строки символов вместо 
функции оэв. 


Использование: 

В регистр дн следует поместить код функции ов. 

В регистр Ат, нужно поместить символ. 

В регистр вн нужно поместить номер страницы. 

В регистр вь требуется записать цвет фона (для графического режима). 


л ъьф > = 


Вызвать прерывание 1пе 101. 


Выход: 
Возвращаемого значения нет. После выполнения функция автоматически 
передвигает курсор и прокручивает (если необходимо) экран. Использова- 
ние управляющих символов (071, 085, ОАВ и 005) приведет к результату, оп- 
ределяемому их стандартным назначением. Пример работы с данной функ- 
цией представлен в листинге 4.17. 





Листинг 4. 47. Использование функции 0 ЕВ. 


пу 59 ЧБ "Тестовая строка $" 
; код программы 
оу АН, ОЕБ ; код функции ОЕБ 
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1еа ВХ, му 159; получаем адрес строки 


@уереае: 

поу АБ, [ВХ] ; записываем первый символ 
стр АБ, '5' ; проверяем конец строки 
Зе ЕХТТ СОРЕ ; выходим из цикла 

1пЕ 108 ; выводим символ на экран 
1пс ВХ ; увеличиваем регистр на 1 


Эр зрогЕ @гереае 


4.2.15. Функция ОРП 


Эта функция позволяет получить текущий видеорежим. 


Использование: 
1. В регистр Ан следует поместить код функции оеБ. 


2. Вызвать прерывание 1 10. 


Выход: 


После успешного выполнения функции в регистр дь будет помещен код те- 
кущего видеорежима. В регистр Ан будет записано число символов в одной 
строке, а в регистр вн — номер активной страницы. Чтобы определить те- 
кущий режим дисплея, можно использовать код, показанный в листин- 
ге 4.18. 


: Листинг 4.18. Использование функции ОЕЪ 





поу АН, ОЕП ; код функции ОЕБ 

ПЕ 105 ; вызываем прерывание 

стр АГ, 00 ; если текстовый 40 х 25 

Зе ТХТ МОРЕ ; передаем управление 

стр АБ, 041 ; если графический 320 х 200 
)е СВАЕ МОШЕ; передаем управление 


4.2.16. Функция 121 


Функция содержит дополнительные подфункции для выполнения различ- 
ных настроек. Поддержка В1О$ данного набора подфункций необязательна. 


4.2.16.1. Подфункция З0Р 


Данная подфункция позволяет установить вертикальное разрешение для 
текстовых режимов. Установленное разрешение вступит в силу только после 
следующей установки режима дисплея. 
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Использование: 
1. В регистр Ан следует поместить код функции 125. 


2. В регистр вь нужно записать код подфункции зон. 


3. В регистр Ат следует поместить значение разрешения. Возможны сле- 
дующие варианты: 00 — 200 строк, 01ь — 350 строк, 02ъ — 400 строк. 


4. Вызвать прерывание 1пе 101. 


Выход: 


Если данная подфункция поддерживается, в регистр Аъ будет записано зна- 
чение 125. Пример кода работы с данной подфункцией приведен в листин- 
ге 4.19. 


Листинг 4.19. Использование функции 12308 


поу АН, 12. ; код функции 126 

поу ВЬ, ЗОВ ; код подфункции 308 

поу АЬ, 021 ; установим 400 строк по вертикали 

116 108 ; вызываем прерывание 

сир АГ, 126 ; проверим результат 

пе ЕВВОК_НМО; функция не поддерживается, переходим к обработчику ошибок 


4.2.16.2. Подфункция 318 

Подфункция позволяет загрузить палитру, используемую по умолчанию. 
Использование: 

1. В регистр Ан следует поместить код функции 125. 

2. В регистр вь нужно записать код подфункции 311. 


3. В регистр АЪ следует поместить код операции. Возможны следующие ва- 
рианты: оон — разрешить загрузку палитры по умолчанию, 01 — запре- 
тить загрузку палитры по умолчанию. 


4. Вызвать прерывание 114 108. 


Выход: 

Если данная подфункция поддерживается, в регистр Ат, будет записано зна- 
чение 125. Пример кода работы с данной подфункцией приводится в лис- 
тинге 4.20. 





Листинг 4.20. Использование функции 12315 
поу АН, 120 ; код функции 126 
поту ВЬ, З11 ; код подфункции 318 


138 Часть [. Работа с аппаратными ресурсами в И/паоиз 


поу АЬ, 00В ; разрешить загрузку палитры по умолчанию 

10е 108 ; вызываем прерывание 

сир АБ, 126 ; проверим результат 

Эпе ЕВКОВ_НМО; функция не поддерживается, переходим к обработчику ошибок 


4.2.16.3. Подфункция 328 


Эта подфункция управляет доступом процессора к видеопамяти и регистрам 
ввода-вывода. 

Использование: 

1. В регистр дн следует поместить код функции 12ъ. 

2. В регистр вь нужно записать код подфункции 325. 


3. В регистр АЪ следует поместить код операции. Возможны следующие ва- 
рианты: 00ъ — разрешить доступ, 01. — запретить доступ. 


4. Вызвать прерывание 1пе 108. 


Выход: 


Если данная подфункция поддерживается, в регистр Ат, будет записано зна- 
чение 125. Пример кода работы с данной подфункцией приводится в лис- 
тинге 4.21. 





поу АН, 12 ; код функции 126 
поу ВЬ, 326 ; код подфункции 325 


поу АБ, 011 ; запретить доступ к видеоконтроллеру 
10 108 ; вызываем прерывание 
спр АГ, 125 ; проверим результат 


Эпе ЕВКОВ НМО; функция не поддерживается, переходим к обработчику ошибок 


4.2.16.4. Подфункция 36В 


Подфункция позволяет управлять регенерацией (обновлением) экрана дис- 
плея. 


Использование: 
1. В регистр дн следует поместить код функции 125. 
2. В регистр вт нужно записать код подфункции 365. 


3. В регистр дь следует поместить код операции. Возможны следующие ва- 
рианты: 00 — разрешить обновление, о1н — запретить обновление. 


4. Вызвать прерывание {пе 101. 
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Выход: 

Если данная подфункция поддерживается, в регистр Ат, будет записано зна- 
чение 125. Пример кода работы с данной подфункцией приводится в лис- 
тинге 4.22. 


Листинг 4.22. Использование функции 12365 





поу АН, 12. ; код функции 128 
поу ВЬ, З6бН ; код подфункции 366 


поу АГ, 01Н ; запретить регенерацию экрана дисплея 
116 108 ; вызываем прерывание 
сир АБ, 12. ; проверим результат 


пе ЕВКОВ_НМО; функция не поддерживается, переходим к обработчику ошибок 


4.2.17. Функция 10008 


Данная функция предназначена для установки одного регистра палитры. 
Использование: 

1. В регистр Ах следует поместить код функции 10005. 

2. В регистр вь нужно записать номер регистра палитры (005—о0ЕЪ). 

3. В регистр вн следует поместить желаемый цвет. 

4. Вызвать прерывание 1пе 10ь. 


Выход: 
Возвращаемого значения нет. 


4.2.18. Функция 10018 


Функция позволяет установить цвет обрамляющей экран рамки. 
Использование: 
1. В регистр Ах следует поместить код функции 10011. 


2. В регистр вн следует поместить желаемый цвет (00.—зЕв). Значение 00, 
соответствует черному цвету. 


3. Вызвать прерывание 1 10н. 


Выход: 
Возвращаемого значения нет. 


4.2.19. Функция 10028 


Функция позволяет одновременно записать значения для всех регистров 
палитры. 
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Использование: 
1. В регистр Ах следует поместить код функции 10021. 


2. В регистр Ез:0х следует поместить указатель на список регистров палит- 
ры. Список регистров должен иметь размер 17 байт, где 16-й байт опре- 
деляет цвет обрамляющей рамки экрана, а байты с 0 по 15 задают цвета 
палитры. 


3. Вызвать прерывание 11 108. 


Выход: 
Возвращаемого значения нет. 


4.2.20. Функция 10031 


Эта функция позволяет управлять битом 7 в байте атрибутов. Данный бит 
отвечает за мигание символа и насыщенность. 


Использование: 
1. В регистр Ах следует поместить код функции 10035. 


2. В регистр вт следует поместить код операции. Возможны следующие ва- 
рианты: 00 — включить насыщенность, 035 — включить мигание. 


3. Вызвать прерывание +пе 105. 


Выход: 
Возвращаемого значения нет. 


4.2.21. Функция 1007В 


Функция позволяет получить определенный регистр палитры. 


Использование: 

1. В регистр Ах следует поместить код функции 1007ь. 

2. В регистр вь следует поместить номер регистра палитры (005—0ЕВ). 
3. Вызвать прерывание 4пе 105. 


Выход: 


При успешном выполнении в регистр вн будет записан цвет для указанного 
регистра палитры. 


4.2.22. Функция 1008В 


Функция позволяет определить текущий цвет обрамляющей рамки экрана. 


Использование: 
1. В регистр Ах следует поместить код функции 10085. 


2. Вызвать прерывание +п% 105. 
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Выход: 


При успешном выполнении в регистр вн будет записано значение цвета 
(00н—ЗЕВ) обрамляющей рамки экрана. 


4.2.23. Функция 10091 


Данная функция позволяет одновременно прочитать все регистры палитры 
и регистр обрамляющей рамки экрана. 


Использование: 

1. В регистр АХ следует поместить код функции 10095. 

2. В регистр Ез: ох следует поместить указатель на массив из 17 байтов. 
3. Вызвать прерывание 1пе 108. 


Выход: 


После выполнения функции выделенный массив будет заполнен данными 
о цветах палитры (от 0 до 15 байта) и значением цвета обрамляющей рамки 
(байт 16). Функция проста и не требует примера. 


4.2.24. Функция 10101 


Функция позволяет установить значения насыщенности цветов для одного 
регистра ЦАП (цифроаналоговый преобразователь). 


Использование: 
1. В регистр Ах следует поместить код функции 1010Ъ. 
2. В регистр вх надо записать номер регистра ЦАП (от 00ъ до ЕЕБ). 


3. В регистр сн требуется занести новое значение насыщенности для зеле- 
ного цвета (от 0 до 63). 


4. В регистр сь требуется занести новое значение насыщенности для синего 
цвета (от 0 до 63). 


5. В регистр он требуется занести новое значение насыщенности для крас- 
ного цвета (от 0 до 63). 


6. Вызвать прерывание 1пе 105. 


Выход: 
Возвращаемого значения нет. 


4.2.25. Функция 10121 


Эта функция позволяет установить значения насыщенности цветов для це- 
лой группы регистров ЦАП. 
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Использование: 
1. В регистр Ах следует поместить код функции 10124. 


2. В регистр вх надо записать номер первого регистра ЦАП (от о0ъ до ЕЕН) 
в группе. 


3. В регистр сн требуется занести новое значение насыщенности для зеле- 
ного цвета (от 0 до 63). 


4. В регистр сх требуется записать количество регистров в группе. 


5. В регистр Ез:0х следует поместить указатель на список описателей для 
каждого регистра группы. Размер каждого описателя равен трем байтам 
(красный, синий, зеленый). Значение каждого байта цвета лежит в про- 
межутке от 0 до 63. Общий размер всей группы должен быть равен 3*сх 
байтов. 


6. Вызвать прерывание зпе 101. 


Выход: 
Возвращаемого значения нет. 


4.2.26. Функция 10131 


Функция позволяет выбрать страницу видеопамяти для регистров цвета 
ЦАП. Данная функция не поддерживает графический режим 135. 


Использование: 
1. В регистр Ах следует поместить код функции 1013н. 


2. В регистр вь надо записать тип операции: 00. — количество страниц, 
015 — номер страницы. 


3. В регистр вн требуется записать одно из следующих значений: для перво- 
го типа надо указать количество страниц (005 — 4, 015 — 16), для второго 
следует определить номер страницы (005—03ь или 005—оЕн). 


4. Вызвать прерывание 104 105. 


Выход: 


Возвращаемого значения нет. Простой пример выбора страницы видеопа- 
мяти с номером 1 показан в листинге 4.23. 





по\ АХ, 10136; код функции 10135 

поту ВЫ, 1 ; выбрать номер страницы 
поу ВН, 016 ; страница с номером 1 
11Е 105 ; вызываем прерывание 
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4.2.27. Функция 10158 


Функция позволяет получить информацию о цвете для указанного регистра 
ЦАП. 

Использование: 

1. В регистр Ах следует поместить код функции 10158. 


2. В регистр вь надо записать номер регистра палитры ЦАП (от 008 до ЕЕЪ). 
3. Вызвать прерывание 1пе 10ь. 


Выход: 

После успешного завершения функции регистры будут содержать следую- 
щие данные: сн — зеленый, съ — синий, он — красный. Пример использо- 
вания функции 10155 представлен в листинге 4.24. 


Листинг 4.24. Использование функции 10156 





поу АХ, 10158; код функции 10158 

поу ВЬ, ОЗр ; читаем регистр 4 

106 105 ; вызываем прерывание 

поу СВЕЕМ, СН; читаем значение насыщенности зеленого цвета 
поу ВЦОЕ, СЪ ; читаем значение насыщенности синего цвета 
поу ВЕР, ОН ; читаем значение насыщенности красного цвета 


К сожалению, нет возможности проверить, правильно ли завершилась 
функция. Содержание регистра Ах многими ВОЗ разрушается. 


4.2.28. Функция 1017 


Данная функция позволяет получить значения насыщенности цветов для 

целой группы регистров ЦАП. 

Использование: 

1. В регистр Ах следует поместить код функции 1017ь. 

2. В регистр вх надо записать номер первого регистра ЦАП (от 008 до ЕЕБ) 
в группе. 

3. В регистр сх требуется записать количество регистров в группе. 

4. В регистр ЕзЗ:ох следует поместить указатель на список описателей для 
каждого регистра группы. Размер каждого описателя равен трем байтам 
(красный, синий, зеленый). Значение каждого байта цвета лежит в про- 


межутке от 0 до 63. Общий размер всей группы должен быть равен 3*сх 
байтов. 


5. Вызвать прерывание 1п* 10ь. 
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Выход: 


После выполнения функции выделенный список будет заполнен данными 
о насыщенности по каждому цвету. 


4.2.29. Функция 101АВ 


Функция позволяет прочитать состояние страницы видеопамяти для регист- 
ров цвета ЦАП. 

Использование: 

1. В регистр Ах следует поместить код функции 101Ав. 


2. Вызвать прерывание 1пе 105. 


Выход: 
После выполнения функции регистр вь будет хранить число страниц (005 — 4, 
015 — 16), а регистр вн — номер текущей страницы (000—о0ЕВ). Простой 
пример для получения информации о текущей странице показан в листин- 
ге 4.25. 





: Листинг 4.25. Использование функции 101АЪ 


поу АХ, 101АБ ; код функции ТОТАБ 

106 106 ; вызываем прерывание 
поу МРАСЕ$, ВЬ; количество страниц 

поу СРАСЕ, ВН ; номер текущей страницы 


4.2.30. Функция 101ВВ 


Функция позволяет выполнить полутоновое преобразование над группой 
регистров цвета. 


Использование: 
1. В регистр Ах следует поместить код функции 10188. 
2. В регистр вх нужно записать номер начального регистра (от 00ь до ЕЕН). 


3. В регистр сх требуется записать количество регистров, подлежащих пре- 
образованию. 


4. Вызвать прерывание зп 108. 


Выход: 
Возвращаемого значения нет. 


4.2.31. Функция 11008 


Эта функция позволяет в текстовом режиме загрузить пользовательские на- 
боры символов, иначе говоря, шрифты. 
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Использование: 
1. В регистр Ах следует поместить код функции 11001. 


2. В регистр вн нужно записать число байтов для одного символа. 


3. В регистр вь нужно записать номер блока знакогенератора. Знакогенера- 
тор представляет собой область памяти, в которой могут храниться до 
8-ми наборов символов (в виде отдельных блоков). Как правило, в боль- 
шинстве случаев применяется первый блок с номером 0. 


4. В регистр сх следует поместить число символов. 
5. В регистр 5х следует поместить смещение к Первому символу из набора. 


6. В ЕЗ:ВР необходимо записать указатель на пользовательский набор сим- 
ВОЛОВ. 


7. Вызвать прерывание 1пе 108. 


Выход: 
Возвращаемого значения нет. 


4.2.32. Функция 1АООР 


Данная функция позволяет определить тип подключенного дисплея. 


Использование: 
1. В регистр Ах следует поместить код функции 1Аоо0н. 


2. Вызвать прерывание 1пе 108. 


Выход: 

После успешного завершения функции регистры будут иметь следующий 
вид: в АБ будет записано значение 1ль, если функция поддерживается, 
в в. — код текущего дисплея (табл. 4.4), ав вн — дополнительный код дис- 
плея (табл. 4.4). Данную функцию удобно использовать для проверки нали- 


чия УСА-совместимого дисплея, но она поддерживается далеко не всеми 
В10$. 


Таблица 4.4. Код дисплея 


Код 





дисплея Описание 
ов Дисплей отсутствует 
018 Монохромный адаптер и дисплей 
02н Адаптер СОА и цветной дисплей 
04в Адаптер ЕСА и цветной дисплей 


05 Адаптер ЕСА и монохромный дисплей 
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Таблица 4.4 (окончание) 


исоАь я Описание 
о6н Адаптер РСА и цветной дисплей 
076 Адаптер УСА и монохромный аналоговый дисплей 
оз Адаптер УСА и цветной аналоговый дисплей 
ОА Адаптер МССА и цветной цифровой дисплей 
ов Адаптер МССА и монохромный аналоговый дисплей 
ос Адаптер МССА и монохромный аналоговый дисплей 
РЕВ Неизвестный тип дисплея 





Кроме рассмотренных возможностей В1О$, существует дополнительный на- 
бор функций УЕЗА В1О$, поддерживающий современные режимы работы 
видеоадаптеров. Этот набор также использует прерывание под номером 
1пе 105. Стандарт УВЕ (УЕЗА В1О$ Ежмепзюп) позволяет управлять ЗУСА 
(Зирег УСА) видеоадаптерами, установленными на современных персональ- 
ных компьютерах. Необходимость работы с УЕЗА В1О$ ‘возникает при ре- 
шении нестандартных задач: создание операционной системы, разработка 
драйверов для видеоплат, разработка другого специального оборудования, 
требующего вывода информации на цветной дисплей. Набор стандартных 
функций может быть дополнен собственными функциями разработчика 
оборудования. 


Рассмотрим подробнее набор функций УЕЗА ВТО$. Каждая функция состо- 
ит из общего кода ага и номера подфункции (например, оон). После вы- 
полнения функции, если она поддерживается, в регистр Ат, заносится значе- 
ние 4ЕЪ. Кроме того, регистр Ан хранит код ошибки, по которому можно 
судить о результате операции. Любое значение кода ошибки, отличное от 
нуля, однозначно укажет на какой-либо сбой. Возможные значения кода 
ошибки приведены в табл. 4.5. 


Таблица 4.5. Коды ошибок УЕЗА ВО$ 








од Описание 
оо, Функция успешно завершена 
01ъ Функция завершена с ошибкой 
02в Функция не поддерживается установленным видеоконтроллером или 
дисплеем 


озв Функция не может быть выполнена в текущем режиме 
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Стандарт УЕЗА ВОЗ поддерживает определенные режимы, перечисленные 


в табл. 4.6. Стандартные режимы начинаются с 1001. 


1015 


1025 


103 


1045 


1056 


1068 


1078 


108в 


1098 


10АВ 


10вв 


10св 


1008 


10ЕВ 


10ЕВ 


1108 


1115 


1126 


1135 


1145 


1156 


116 


1176 


1185 


11985 


640 х 400 
640 х 480 
800 х 600 
800 х 600 
1024 х 768 
1024 х 768 
1280 х 1024 
1280 х 1024 
80 х 60 
132 х 25 
132 х 43 
132 х50 
132 х 60 
320 х 200 
320 х 200 
320 х 200 
640 х 480 
640 х 480 
640 х 480 
800 х 600 
800 х 600 
800 х 600 
1024 х 768 
1024 х 768 
1024 х 768 
1280 х 1024 


16 
256 
16 
16 
16 
16 
16 
З2К (1:5:5:5) 
64К (5:6:5) 
16, 8М (8:8:8) 
З2К (1:5:5:5) 
64К (5:6:5) 
16,8М (8:8:8) 
З2К (1:5:5:5) 
64К (5:6:5) 
16, 8М (8:8:8) 
З2К (1:5:5:5) 
64К (5:6:5) 
16,8М (8:8:8) 
З2К (1:5:5:5) 





Таблица 4.6. Список стандартных режимов УЕЗА ВО$ 


Количество цветов 


Графический 
Графический 
Графический 
Графический 
Графический 
Графический 
Графический 
Графический 
Текстовый 

Текстовый 

Текстовый 

Текстовый 

Текстовый 

Графический 
Графический 
Графический 
Графический 
Графический 
Графический 
Графический 
Графический 
Графический 
Графический 
Графический 
Графический 


Графический 
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т1вь 1280 х 1024 16,8М (8:8:8) Графический 
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Таблица 4.6 (окончание) 


Количество цветов 


64К (5:6:5) 


1280 х 1024 







Графический 


Специальный режим для сохранения 
текущего состояния видеопамяти 


4.2.33. Функция 4РООР 


Функция позволяет получить информацию о видеоконтроллере: версию 
УЕЗА В1О0$, поддерживаемые возможности устройства, а также различную 
информацию о производителе видеоадаптера. 


Использование: 
1. В регистр Ах следует поместить код функции 4гоов. 


2. В ЕЗ:рт необходимо поместить указатель на буфер размером 512 байт, 
куда будет записана вся полученная информация. Формат буфера пред- 
ставлен в табл. 4.7 


3. Вызвать прерывание +пе 10Ъ. 


Выход: 


Если функция не поддерживается, регистр аъ будет содержать значение деп. 
Регистр Ан будет установлен в соответствии с табл. 4.5. Выделенный буфер 
будет хранить всю полученную информацию о видеоконтроллере. 


Смещение 
о0ь 


046 


065 


АВ 


ОЕБ 


Таблица 4.7. Формат буфера для УЕЗА ВО$ 


Описание 


Сигнатура стандарта УВЕ МУЕЗА 


Версия УЕЗА В!О$ (0300ъ для третьей или 0200ъ для второй, 0102 для 
версии 1.2). Младший байт указывает на минорную версию, а стар- 
ший — на мажорную 


Указатель на ОЕМ-строку, которая может содержать описание микро- 
схемы видеоадаптера или описание продукта для правильного ис- 
пользования драйвером. Длина строки не регламентируется, но реко- 
мендуется ограничивать ее 256 байтами 


Описание поддерживаемых возможностей видеоадаптера (табл. 4.8) 


Указатель на список поддерживаемых видеорежимов (каждый режим 
занимает два байта и содержит все возможные режимы видеоадапте- 
ра, даже те, которые не годдерживает монитор) 
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Таблица 4.7 (окончание) 


Смещение Описание 


125 Полный размер видеопамяти (выражен числом блоков по 64 Кбайт). 
Например, для 32 Мбайт памяти будет возвращено значение 512 
(512 * 64) 

14в Код программной версии \/ВЕ 

166 Указатель на строку с именем производителя 

ТАВ Указатель на строку с названием устройства 

1ЕВ Указатель на строку с версией устройства 

225 Зарезервированная область \/ВЕ (222 байта) 

100: Область данных (256 байт) 


Таблица 4.8. Поддерживаемые возможности видеоадаптера 


Бит Описание 
0 Разрядность ЦАП (1 -— 8 бит, 0 — 6 бит) 
1 Поддержка УСА (1 — не совместим, 0 — совместим) 
2 Использование НАМПАС (1 — используется бит очистки функции 09ъ 


при работе с большими блоками данных, 0 — обычный режим работы) 


3 Поддержка стереоскопического синхросигнала видеоадаптером 
(1 — поддерживается, 0 — не поддерживается) 


4 Поддержка стереосигнала (1 — через разъем УЕЗА Е\С, через стерео- 
разъем МЕЗА) | 


5—31 Резерв 


Рассмотрим простой пример кода для получения информации об установ- 
ленном видеоконтроллере (листинг 4.26). 


Листинг 4.26. Использование функции 4Е005 : 





; выделяем память для хранения информации, размером 512 байт 
УТРЕО ТМЕО а> 512 ар (?) 

ТОТАЬ МЕМОВУ аа ? 

; код программы 

оу ВХ, 05 ; адресуем сегмент данных 

поу ЕЁ5, ВХ ; передаем адрес 

поу ОТ, ОЕЕзее УТРЕО ТМЕО 
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поу АХ, 4РООЙ; код функции АРООБ 


ре 108 ; вызываем прерывание 

сир АБ, 4ЕП ; если не равно АЕБ 

Эпе № 50Р ; функция не поддерживается 
спр АН, 0 ; если не 0 


322 ЕВВОВ НМО; произошла ошибка 

; сохраняем полный размер видеопамяти в килобайтах 
хог ЕАХ, ЕАХ ; обнуляем регистр 

пох АХ, [мога рег УТОЕО ТМЕО + 128] 

501 АХ, 6 ; умножаем результат на 64 

; сохраняем значение в переменную ТОТАЪ МЕМОВУ 
по\у ТОТАЪ МЕМОВУ, ЕАХ 


4.2.34. Функция 47018 


Данная функция позволяет получить различную информацию для указанно- 
го режима. 

Использование: 

1. В регистр Ах следует поместить код функции 4ко1в. 


2. В регистр сх нужно записать номер режима. 


3. В ЕЗ:рт помещается указатель на буфер размером 256 байт, куда будет 
записана вся полученная информация. Формат буфера представлен в 
табл. 4.8. 


4. Вызвать прерывание 1пе 101. 


Выход: 

Если функция не поддерживается, регистр Ат, будет содержать значение 4Ег. 
Регистр Ан будет установлен в соответствии с табл. 4.5. Выделенный буфер 
будет хранить всю полученную информацию о видеоконтроллере. Формат 
буфера показан в табл. 4.9. 


Таблица 4.9. Формат описателя видеорежима 


Смещение еРСИй 6 Описание 
о0в Для всех версий — Атрибуты режима (табл. 4.10) 
02. Поддержка атрибутов окна А (табл. 4.11) 
Зв - Поддержка атрибутов окна В (табл. 4.11) 
048, Поддержка минимального размера в килобайтах, 


необходимого для размещения окна в буфере 
видеопамяти 
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Таблица 4.9 (продолжение) 





Версия 
Смещение ЕВА ВЮЗ Описание 

о6ы Указывает на размер окна в килобайтах 

о8В Адрес сегмента окна А в адресном пространстве 
процессора для реального режима 

ОАВ Адрес сегмента окна В в адресном пространстве 
процессора для реального режима 

осв Указывает на смещение адреса функции, рабо- 
тающей с окнами в памяти 

105 Указывает на полное число байтов для одной 
строки растра (развертки) 

125 Для версии 1.2 — Определяет горизонтальное разрешение дисплея 

и старше в пикселах или символах 

14в Определяет вертикальное разрешение дисплея 
в пикселах или символах 

165 Определяет ширину символьной ячейки в пиксе- 
лах 

175 Определяет высоту символьной ячейки в пиксе- 
лах 

185 Определяет количество плоскостей в памяти, дос- 
тупных указанному режиму 

195 Указывает на количество битов, выделенных ука- 
занным режимом на один пиксел 

ТАБ Указывает на количество банков памяти для раз- 
вертки 

1ВВ Указывает на тип организации общей памяти 
(табл. 4.12) 

1сВ Указывает на размер одного банка памяти раз- 
вертки, выраженный в однокилобайтных модулях 

108 Указывает на количество (минус 1) полных копий 
экрана, которые могут быть размещены в буфере 
памяти 

1ЕВ Зарезервировано и равно 1 для версии 3.0 

1ЕВ Для Окес{ Союг Размер в битах красной составляющей цвета 
пиксела 

208 Указывает на битовую позицию красной состав- 


ляющей цвета пиксела 
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Таблица 4.9 (продолжение) 
Версия 
Смещение МЕЗА В10$ Описание 
218 Размер в битах зеленой составляющей цвета 
пиксела 
226 Указывает на битовую позицию зеленой состав- 
ляющей цвета пиксела 
23ь Размер в битах синей составляющей цвета пик- 
села 
24В Указывает на битовую позицию синей состав- 
ляющей цвета пиксела 
256 Размер в битах резервной составляющей цвета 
пиксела 
268 Указывает на битовую позицию резервной со- 
ставляющей цвета пиксела 
275 Атрибуты режима Огес( Со|ог (табл. 4.13) 
288 Для версии 2.0 Физический 32-разрядный адрес буфера памяти 
и старше 
2СВ Зарезервировано и должно быть равно 0 
Зов Зарезервировано и должно быть равно 0 
32й Для версии 3.0 Указывает на количество байтов в одной строке 
и старше растра (развертки) для режима линейной адреса- 
ции 
З4В Указывает на количество (минус 1) полных копий 
экрана, которые могут быть размещены в буфере 
памяти для страничного режима 
358 Указывает на количество (минус 1) полных копий 
экрана, которые могут быть размещены в буфере 
памяти для режима линейной адресации 
з6в Размер в битах красной составляющей цвета 
пиксела для режима линейной адресации 
375 Указывает на битовую позицию красной состав- 
ляющей цвета пиксела для режима линейной ад- 
ресации 
385 Размер в битах зеленой составляющей цвета 
пиксела для режима линейной адресации 
398 Указывает на битовую позицию зеленой состав- 


ляющей цвета пиксела для режима линейной ад- 
ресации 
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Таблица 4.9 (окончание) 


Версия 


Смещение УЕЗА ВЮ$ Описание 


408 


428 


436 


Бит 


о ям г © 


Размер в битах синей составляющей цвета пик- 
села для режима линейной адресации 


Указывает на битовую позицию синей состав- 
ляющей цвета пиксела для режима линейной ад- 
ресации 


Размер в битах резервной составляющей цвета 
пиксела для режима линейной адресации 


Указывает на битовую позицию резервной со- 
ставляющей цвета пиксела для режима линейной 


адресации 


Указывает на максимальную частоту обновления 
пиксела на дисплее, измеряемую в герцах 


Зарезервированный остаток 189 байт 


Таблица 4.10. Атрибуты режима 


Описание 


Поддержка режима текущей аппаратной конфигурацией 
(1 — поддерживается, 0 — не поддерживается) 


Зарезервирован и всегда равен 1 


Поддержка ВЮ$ функций ТТУ (1 — поддерживает, 0 — не поддерживает) 
для вывода текста 


Режим цветности (1 — цветной, 0 — монохромный} 
Тип режима (1 — графический, 0 — текстовый) 
Поддержка УСА (1 — не поддерживается, 0 — поддерживается) 


Поддержка оконной адресации памяти (1 — не поддерживается, 
0 — поддерживается) 


'Поддержка линейной адресации памяти (1 — поддерживается, 


0 — не поддерживается) 


Поддержка режима двойного сканирования (1 — поддерживается, 
0 — не поддерживается) 


Поддержка режима чередования (1 — поддерживается, 
0 — не поддерживается) 
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Бит 


10 


11 


12 


13—15 


Бит 


о0в 


075 
085-ОЕВ 


100-РЕВь 
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Таблица 4.10 (окончание) 
Описание 


Поддержка аппаратной тройной буферизации (1 — поддерживается, 
0 — не поддерживается) | 


Поддержка аппаратной стереоскопии дисплея (1 — поддерживается, 
0 — не поддерживается) 


Поддержка сдвоенного начального адреса (1 — поддерживается, 
0 — не поддерживается) 


Резерв 


Таблица 4.11. Атрибуты окна 
Описание 


Поддержка перемещения окна или окон (1 — поддерживается, 
0 — не поддерживается) 


Поддержка чтения из окна (1 — поддерживается, 0 — не поддерживается) 
Поддержка записи в окно (1 — поддерживается, 0 — не поддерживается) 


Резерв 


Таблица 4.12. Тип организации памяти 


Описание 

Текстовый режим 

Графический режим ССА 

Графический режим Негсшез 

Плоский режим 

Режим с упакованными пикселами 

Не режим цепочки под номером 4 и 256 цветов 
Режим Онес{ Союг 

УУ\-режим 

Резерв 


Резерв 
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Таблица 4.13. Атрибуты режима ОйесЕ Соог 


Бит Описание 


0 Состояние цветового шаблона ЦАП (1 — программируемый, 
0 — фиксированный) 


1 Состояние битов резервных полей цвета 
{1 — могут использоваться в программе, 0 — зарезервированы) 


4.2.35. Функция 42021 


Функция позволяет установить поддерживаемый УЕЗА В1О$ режим. 


Использование: 
|. В регистр Ах следует поместить код функции 4Е02в. 


2. В регистр вх нужно записать номер видеорежима (см. табл. 4.6). Кро- 
ме значения режима можно определить дополнительные параметры 
{табл. 4.14). 


3. Вызвать прерывание 1пе 10%. 


Выход: 
Если функция не поддерживается, регистр АЪ будет содержать значение 4Еь. 
Регистр Ан будет установлен в соответствии с табл. 4.5. 


Таблица 4.14. Формат регистра вх для функции 4го28 


Бит Описание 


0—8 Номер режима (см. табл. 4.6) 
9—10 — Зарезервированы и должны быть установлены в 0 


11 Установка частоты обновления (1 — использовать установленную 
пользователем, 0 — использовать заданную по умолчанию) 


12—13  Зарезервированы и должны быть установлены в 0 


14 Режим буфера памяти (1 — использовать линейную адресацию буфера 
видеопамяти, 0 — использовать оконную (постраничную) модель буфера 
памяти) 


15 Установка очистки памяти (1 — не очищать память, 
0 — очищать память дисплея) 


Простой пример для установки режима под номером 102ь (800х600 х 16) 
показан в листинге 4.27. 
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: Листинг 4.27. Использование функции 42026 





поУ АХ, 4ЕО26; код функции 4Е028 

шоу ВХ, 1021 ; номер режима 

206 106 ; вызываем прерывание 

спр АБ, АЕБ ; если не равно 4ЕБ 

Зре № 50Р ; функция не поддерживается 
стр АН, 0 ; если не 0 

302 ЕВВОВ_НМО; произошла ошибка 


4.2.36. Функция 4Р0ЗВ 


Эта функция позволяет узнать номер текущего видеорежима. При этом пра- 
вильное определение режима гарантируется только тогда, когда для уста- 
новки режима использовалась функция 4Ео2к. 

Использование: 

1. В регистр Ах следует поместить код функции 4Е0зь. 


2. Вызвать прерывание 11% 108. 


Выход: 


Если функция не поддерживается, регистр Ат будет содержать значение 4ЕК. 
Регистр Ан будет установлен в соответствии с табл. 4.5. В случае успешного 
выполнения в регистр вх будет записан номер текущего видеорежима. Фор- 
мат этого значения показан в табл. 4.15. 


Таблица 4.15. Формат регистра вх для функции 4ЕоЗь 


Бит Описание 
0—13 Номер режима (см. табл. 4.6) 


14 Режим буфера памяти (1 — используется линейная адресация буфера 
видеопамяти, 0 — используется оконная (постраничная) модель буфера 
памяти) 


15 Очистка памяти (1 — память не очищается, 0 — память очищается) 


Рассмотрим простой пример для установки режима под номером 102. 
(800 х 600 х 16) и получения текущего номера видеорежима (листинг 4.28). 


Листинг 4.28. Использование функции 4Р0ЗЬ 


по\У АХ, 4Е021; код функции 4Р026 
по\у ВХ, 1021 ; номер режима 
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06 108 ; вызываем прерывание 

спр АЪ, 4ЕР ; если не равно АЕВ 

Эпе МО 5ОРРВТ; функция не поддерживается 
ср АН, 0 ; если не 0 

312 ЕКВОВ_НМО; произошла ошибка 

поУ АХ, АЕРОЗЬ; код функции 4ЕОЗВ 

хог ВХ, ВХ ; обнуляем регистр 

106 108 ; вызываем прерывание 

апа ВХ, ЗЕЕЕВ; выделяем номер режима 

сшр ВХ, 1021 ; проверяем режим 

Эпе ЕВВОВ НМ№О; номер режима не соответствует установленному 


4.2.37. Функция 4Р04В 


Данная функция позволяет сохранить или восстановить состояние видео- 
адаптера дисплея. Функция сохраняет все параметры видеоадаптера для те- 
кущего режима и может восстановить их, если режим был изменен. 


Использование: 

1. В регистр Ах следует поместить код функции 4204ь. 

2. В регистр от, следует записать один из следующих колов: 
» 00- — определить размер буфера для сохранения данных; 
® 011 — сохранить текущее состояние; 
® 02. — восстановить состояние. 


3. В регистр сх нужно записать слово (16 бит), описывающее лополнитель- 
ные указания. Формат слова приведен в табл. 4.16. 


4. В ез:вх надо поместить указатель на буфер данных. Если в регистре от 
указан код оо, определять буфер не требуется. 


5. Вызвать прерывание 1пе 108. 


Таблица 4.16. Формат регистра сх для функции 4Е04ь 





Бит Описание 


0 Состояние аппаратных средств видеоадаптера 
1 Состояние данных в ВОЗ 

2 Состояние ЦАП 

3 Состояние регистров видеоадаптера 


4—15 — Не используются и должны быть установлены в 0 
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Выход: 


Если функция не поддерживается, регистр Ат, будет содержать значение АЕ. 
Регистр Ан будет установлен в соответствии с табл. 4.5. В случае успешного 
выполнения регистр вх будет хранить необходимое количество блоков (по 
64 байта каждый) для буфера данных. Естественно, это касается только опе- 
рации определения размера буфера (в от, находится оон). 


4.2.38. Функция 47058 


Функция позволяет управлять окнами памяти на экране дисплея. Перед ис- 
пользованием данной функции следует убедиться, что текущий режим под- 
держивает оконную адресацию памяти, а также координаты окна и мини- 
мальный размер, выделенный для окна. Все эти данные можно получить 
с помощью функции 4Ео1н. 


Использование: 
[. В регистр Ах следует поместить код функции 42058. 


2. В регистр вн следует записать один из следующих кодов: 00ь — устано- 
вить окно в памяти, 01: — получить текущее окно в памяти. 


В регистр вт, нужно записать номер окна: 00ь — окно А, 016 — окно В. 


4. В регистр ох надо поместить номер окна в видеопамяти в единицах дета- 
лизации окна (например, килобайтах}. Используется только для опера- 
ции установки окна в памяти (001). 


5. Для 32-разрядного защищенного режима дополнительно необходимо 
установить селектор для регистров в отображаемой памяти. 


6. Вызвать прерывание 1пе 10%. 


Выход: 


Если функция не поддерживается, регистр Ат будет содержать значение дЕЪ. 
Регистр Ан будет установлен в соответствии с табл. 4.5. В случае успешного 
выполнения регистр ох будет хранить номер окна в единицах детализации 
окна. Это истинно только для операции получения текущего окна в памяти 
(отв). 


4.2.39. Функция 4206 


Эта функция предназначена для получения или установки логической дли- 
ны строки развертки. Данные, получаемые от функции, позволяют устано- 
вить логический буфер памяти для дисплея, который всегда больше отобра- 
жаемой на экране области. Функция может с успехом применяться не толь- 
ко в графических, но и в текстовых режимах. 
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Использование: 
|. В регистр Ах следует поместить код функции АЕОбь. 


2. В регистр въ нужно записать код операции: 
. 005 — установить длину строки развертки в пикселах; 
» 01: — получить длину строки развертки; 
® 02. — установить длину строки развертки в байтах; 
» 03н — получить максимально возможную длину строки развертки. 


3. В регистр сх надо записать определенное значение, в зависимости от ко- 
да операции. Для операции 00н нужно указать желательную ширину 
в пикселах, а для 026 — желательную ширину в байтах. В остальных 
случаях (01ь и о3ь) этот регистр не используется. 


4. Вызвать прерывание зп 108. 


Выход: 


Если функция не поддерживается, регистр Ат, будет содержать значение дев. 
Регистр Ан будет установлен в соответствии с табл. 4.5. В случае успешного 
выполнения регистр вх будет хранить количество байт в одной строке раз- 
вертки, а регистр сх — фактическое число пикселов для одной строки раз- 
вертки, округленное до целого значения. 


4.2.40. Функция 4Р07В 


Функция позволяет получить или установить начальные координаты экрана. 
Для 32-разрядного режима в регистр сх следует записать начальный адрес 
дисплея (биты 0—15), а в регистр рх— вторую часть адреса дисплея (би- 
ты 16-31). 


Использование: 
|. В регистр Ах следует поместить код функции 4ЕОТь. 
2. В регистр вн нужно записать нулевое значение. 


3. В регистр въ нужно записать код операции. Возможные значения пока- 
заны в табл. 4.17. 


4. В регистр Есх следует записать слелующее значение: для кодов операции 
02н и 82. надо установить начальный адрес дисплея в байтах; для кодов 
03зн и 835 — левый начальный адрес экрана в байтах. 


5. В регистр ЕБХ следует записать следующее значение: для кодов операции 
ЗН и 83н — правый начальный адрес экрана в байтах. 


6. Если код операции равен оон или 80%, в регистр сх записывается первый 
отображаемый пиксел в строке развертки. 
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7. Если код операции равен ооз или 801, в регистр ох записывается первая 
отображаемая строка развертки. 


8. Только для 32-разрядного защищенного режима надо указать селектор 
для регистров в отображаемой памяти. 


9. Вызвать прерывание 1% 10. 


Выход: 

Если функция не поддерживается, регистр дт, будет содержать значение дет. 
Регистр Ан будет установлен в соответствии с табл. 4.5. В случае успешного 
выполнения регистр вн будет хранить значение 0, если код операции равен 
о1н. В регистр сх будет помешен первый отображаемый пиксел в строке 
развертки (код операции равен о1н) или 0 (код операции равен о4з). В ре- 
гистр сх будет помещена первая отображаемая строка развертки, если код 
операции равен оль. | 


Таблица 4.17. Коды операций для функции 4Е07в 





Код Описание 
операции 
16-разрядный режим 
ов Установить начальные координаты экрана 
018 Получить начальные координаты экрана 
028 Установить список начальных координат экрана 
ов Установить список начальных координат для стереоскопического 
экрана 
04в Получить список начальных координат экрана 
058 Включить стереоскопический режим 
о6В Выключить стереоскопический режим 
зов Установить начальные координаты экрана в течение обратного 
хода луча по вертикали 
828 Установить начальные координаты экрана в течение обратного 
хода луча по вертикали (альтернативный вариант) 
83В Установить начальные координаты экрана в течение обратного 


хода луча по вертикали для стереоскопического экрана 





32-разрядный режим 






Установить начальные координаты экрана 





808 Установить начальные координаты экрана в течение обратного 


хода луча по вертикали 
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4.2.41. Функция 4РОЗ8Н 


Эта функция позволяет получить и установить формат регистров палитры 
для ЦАП видеоконтроллера. 


Использование: 
1. В регистр Ах следует поместить код функции 4Ео8н. 


2. В регистр вь следует записать один из следующих кодов: оон — устано- 
вить формат палитры, 01п — получить текущий формат палитры. 


3. В регистр вн нужно записать первичный набор битов цвета. Используется 
только во время установки формата палитры (00). 


4. Вызвать прерывание пе 108. 
Выход: 
Если функция не поддерживается, регистр ль будет содержать значение 4Е®. 


Регистр Ан будет установлен в соответствии с табл. 4.5. В случае успешного 
выполнения регистр вн будет хранить текущее количество битов для цвета. 


4.2.42. Функция 4РОЭП 


Функция позволяет получить или установить данные для регистров палитры. 
Использование: 
1. В регистр АХ следует поместить код функции 4Еоэн. 
2. В регистр вь следует записать один из следующих кодов: 
» 00. — установить данные для палитры; 
» 01. — получить текущие данные палитры; 
® 02. — установить данные для второй палитры; 
» 03. — получить текущие данные для второй палитры; 
» 30: — установить данные для палитры в течение обратного хода луча. 


3. В регистр сх нужно записать количество обновляемых регистров палитры 
(максимум 256). 


4. В регистр ох требуется записать номер первого регистра палитры, с кото- 
рого начнется обновление данных. 


5. В з:0т нужно поместить указатель на таблицу значений палитры. 


6. Для 32-разрядного режима следует в 0$ указать селектор для регистров 
в отображаемой памяти. 


7. Вызвать прерывание зпе 103. 
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Выход: 


Если функция не поддерживается, регистр дь будет содержать значение дЕв. 
Регистр Ан будет установлен в соответствии с табл. 4.5. 


4.2.43. Функция 4РОАВ 


Данная функция позволяет получить интерфейс защищенного режима. 
Функция возвращает указатель на таблицу кодов для обычного защищенно- 
го режима. Функция является необязательной для УВЕ версии 3.0 и может 
не поддерживаться видеоадаптером. 


Использование: 

1. В регистр Ах следует поместить код функции АЕОАН. 
2. В регистр вь следует записать значение оон. 

3. Вызвать прерывание 1пе 108. 


Выход: 


Если функция не поддерживается, регистр Аь будет содержать значение д4ЕЪ. 
Регистр Ан будет установлен в соответствии с табл. 4.5. В случае успешного 
выполнения в Е$ будет записан сегмент таблицы реального режима, авот — 
смещение к таблице. В регистр сх запишется значение длины таблицы 
(включая защищенный режим) в байтах. 


На этом можно завершить рассмотрение возможностей ВОЗ по управле- 
нию видеоадаптером и познакомиться с непосредственным программирова- 
нием аппаратных портов видеоконтроллера. 


4.3. Использование портов 


Перед тем как рассказать о программировании портов видеоконтроллера, 
хочу сделать важное замечание: будьте предельно ВНИМАТЕЛЬНЫ и 
ОСТОРОЖНЫ. Случайно сделанная ошибка (возможны описки и в самой 
книге) может привести к выходу из строя дисплея вплоть до его возгорания. 
Перепроверяйте по несколько раз свои действия, а лучше советуйтесь со 
знающими специалистами. Для программирования портов видеоадаптера 
рекомендую использовать старый монитор, с которым не жалко будет рас- 
статься. Несоблюдение этих простых правил может повлечь серьезные по- 
следствия, за которые читатель будет нести ответственность самостоятельно. 


Стандартный УСА-совместимый видеоконтроллер поддерживает следующие 
типы регистров: 


1. Внешние регистры. 
2. Регистры графического контроллера. 
3. Регистры контроллера атрибутов. 
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4. Регистры контроллера СВТ. 
5. Регистры ЦАП. 
6. Регистры синхронизатора. 


Список всех адресов регистров для стандартного видеоконтроллера приве- 
ден в табл. 4.18. Рассмотрим работу с регистрами подробнее. 


Таблица 4.18. Адреса регистров видеоконтроллера 


Адрес 


регистра ИМЯ Регистра 


ЗВ4В САТС Сопгойег Адагезз Нед ег 


ЗВ5Н СВТС Согигойег Баа Ведег 

ЗВАВ шру Заз #1 Вед ег (чтение) или Ееашге Согиго! Вед ег (запись) 

Зсон АнгЬьше Адагез/Оза Вед ег 

ЗС АНиЬШе Оаа Веад Ведзег 

328 пра Заз #0 Ред ег (чтение) или Мзсейапеоиз Омри Вед ег 
{запись} 

зсан Зеадиепсег Адагез$ Нед ег 

ЗС5Н Зеадцепсег Оаа Недег 

3С7В ОАС Уве Ведег (чтение) или ОАС Адагезз Веа4 Моде Вед ег 
(запись) 


Ее: ОАС Адагезз М/ще Моде НВедег 
зсэв ОАС Ба Вед ег 


ЗСАВ Реа\иге Сотго! Вед ег (чтение) 

Зссв М!эсеНапеоцз Омрш Вед ег (чтение) 

ЗСЕН Сгарсз Сопгоег Адагезз Нед ег 

ЗСРЬ СгарНсз Согигойег Оаа Вед ег 

3р4в СВТС Согигойег Адагез$ Нед ег 

ЗО5В СВАТС Сотгойег Оза Вед ег 

ЗБАВ прё З4ам$ #1 Вед ег (чтение) или Ееаиге Сопо! Ведег (запись) 


4.3.1. Внешние регистры 


Данные регистры позволяют управлять различными общими настройками, а 
также получать различную информацию о состоянии контроллера. 
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В данную группу входят четыре основных регистра: 


О регистр общих настроек (М!5сеЙапеои$ Ошриш Кезчег). Доступ для запи- 
си осуществляется через порт зс2ь, для чтения — через порт зссв; 


П регистр особенностей (Ееашге Сопо! Кезег). Доступ для записи про- 
изводится через порт зрдв (цветной режим) и ЗВАБ (монохромный ре- 
жим), для чтения — через порт ЗСАВ; 


П первый регистр состояния (при З{аи5 #0 Кезчег). Доступен только для 
чтения через порт зс2н; 


П второй регистр состояния (при Заз #1 Кезчег). Доступен только для 
чтения через порт зрав (цветной режим) или зВАВ (монохромный режим). 


4.3.1.1. Регистр общих настроек 


Размер регистра равен 8 бит. Регистр управляет частотой синхронизации, 
выбором страниц памяти, полярностью горизонтальных и вертикальных 
импульсов. Формат регистра представлен в табл. 4.19. 


Таблица 4.19. Формат регистра общих настроек 


Бит Описание 


0 Выбор адресов ввода-вывода для контроллера САТ 
1 Доступ к видеопамяти 
2—3 Частота синхронизации 
4 Резерв 
5 Выбор четной или нечетной страницы видеопамяти 
6 Полярность горизонтальной синхронизации 
7 


Полярность вертикальной синхронизации 


Остановимся подробнее на каждой строке таблицы. 


С Бит 0 используется для установки адресов управления контроллера СВТ 
{катодно-лучевой трубки). Если бит установлен в |, используются порты 
зр4в и 3р5й. Если бит установлен в 0, будут выбраны порты зва4в и ЗВ5В. 


П Бит | управляет доступом к видеопамяти устройства. Установка бита в | 
разрешает системе доступ к памяти видеоконтроллера. Установка бита 
в 0 запрешает доступ. 


С Биты 2 и 3 управляют выбором частоты синхронизации. Значение 00а 
указывает на выбор частоты 25 МГц (точнее 25,175), а значение 01. — на 
частоту 28 МГц (или 28,322). 
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О Бит 4 зарезервирован и не используется. 


О Бит 5 управляет выбором четной (значение равно 0) или нечетной (зна- 
чение равно 1) страницы видеопамяти. 


О Бит 6 управляет полярностью горизонтальной синхронизации. Значе- 
ние 0 соответствует положительной полярности сигнала. 


О Бит 7 управляет полярностью вертикальной синхронизации. Значение 0 
соответствует положительной полярности сигнала. Может использоваться 
совместно с битом 6 для управления вертикальным размером экрана. 


4.3.1.2. Регистр особенностей 


Размер регистра равен 8 бит. Реально задействованы только 0 и 1 биты, и 
оба являются служебными. Практическое применение этого регистра не до- 
кументируется. 


4.3.1.3. Первый регистр состояния 


Размер регистра равен 8 бит. Бит 7 отвечает за прерывание обратного хода 
луча. Биты 5 и 6 указывают на присутствие дополнительных устройств. Бит 
4 определяет наличие монитора. Данный регистр может иметь и другой 
формат, поэтому на него не стоит полагаться. 


4.3.1.4. Второй регистр состояния 


Размер регистра равен 8 бит. Он позволяет получить информацию об обрат- 
ном ходе луча. Формат регистра представлен в табл. 4.20. 


Таблица 4.20. Формат второго регистра состояния 





Бит Описание 





0 Обратный ход луча по горизонтали или вертикали 
1—2 — Резерв 

З Обратный ход луча по вертикали 
4—7 Резерв 





При этом бит 0 указывает на наличие обратного хода луча по горизонтали 
или вертикали. Значение 0 определяет обратный ход луча. 


Бит 3 указывает на наличие обратного хода луча только по вертикали. Если 
значение равно 1, происходит обратный ход луча. 


Рассмотрим примеры работы с внешними регистрами. Попробуем устано- 
вить частоту синхронизации 25 МГи (листинг 4.29). 
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хог АХ, АХ ; обнуляем регистр 

шоу ОХ, ОЗССВ ; выбираем порт для чтения 

11 АГ, ОХ ; читаем байт из порта 

апа АТ, 011005; устанавливаем частоту 25 МГц 
шоу ОХ, 03С2В ; выбираем порт для записи 

очЕ ОХ, АХ ; записываем значение в порт 


Аналогичный пример для С++ показан в листинге 4.30. 


ОМОВО @мВезо1Е = 0; // переменная для хранения результата 
// читаем байт из порта ОЗССВ 

1пРохе ( 0х03СС, &амВезо1е, 1); 

// устанавливаем частоту 25 МГц 

ЧмВези1е &= 0х0С; 

// записываем значение в порт 03628 

ооЕРохЕ (0х03С2, амВезо1е, 1); 


Рассмотрим еще один пример для определения обратного хода луча по вер- 
тикали (листинг 4.31). 





: Листинг 4.31. Определение момента обратного хода луча по вертикали 


поу ОХ, ОЗРАБ ; выбираем порт для чтения 


@Епа Веам 
11 АБ, ОХ ; читаем байт из порта 
фезЕ АГ, 8 ; состояние бита 3 


)п2 @Епа Веам ; ждем окончание обратного хода луча 
@5ЕагЕ Веаш: ; ждем начала следующего луча 

1 АБ, ОХ ; читаем байт из порта 

апа АБ, 010005; проверяем бит 3 

2 @56ахге Веам 


Аналогичный пример для С++ будет представлен в листинге 4.32. 





Листинг 4.32. Определение момента обратного хода луча по вертикали в С++ 


ОМОВО ЧмВези1е = 0; // переменная для хранения результата 
// читаем байт из порта ОЗРАВ 
1пЕ 1Тилема1е = 1000; 
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// ждем окончание обратного хода луча 
ир11е (-- 1Таемате > 0) 
{ 
// читаем состояние порта 
1пРохЕ ( ОхОЗрА, &ЧмВезо1е, 1); 
ЗЕ ( (ЗмВезо1е & 0х08) == 0х00) Ьгхеак; 
// закончилось время ожидания 
1Е ( 1Тумема1е < 1) гебохгп МУ ЕВВОВ ТТМЕ; 
} 
116 1Тущема1е = 1000; 
// ждем начала следующего луча 
мр11]е ( -- 1Туаемале > 0) 
{ 
// читаем состояние порта 
ЗпРохе ( 0хОЗРА, &ЧмВезо1е, 1); 
1Е ( (ЧмВезу16 & 0х08) == 0х00) Бгеак; 
// закончилось время ожидания 
1Е ( 1Тлщема1е < 1) гебогп МУ ЕВВОК _ТТМЕ; 


4.3.2. Регистры графического контроллера 


Данные регистры управляют доступом процессора к видеопамяти. Для ука- 
зания адреса используется порт ЗСЕВ, а для передачи данных — порт зсЕв. 
Графический контроллер поддерживает 9 индексных регистров (от ов до 81). 
Каждый индексный регистр отвечает за определенные настройки. Список 
индексных регистров приведен в табл. 4.21. 


Таблица 4.21. Список индексных регистров графического контроллера 


индексных регистра Описание 
008 Регистр установки/сброса 
018 Регистр разрешения для установки/сброса 
028 — Регистр сравнения цвета 
ов Регистр управления циклическим сдвигом данных 
048 Регистр выбора плоскости чтения 
058 Регистр управления режимом работы 
о6й Графический регистр общего назначения 
078 Регистр сброса цветовых плоскостей 


08в Регистр битовой маски 
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Принцип работы с графическим контроллером следующий. В порт адреса 
ЗСЕН следует записать код индексного регистра. После этого можно переда- 
вать или получать данные через порт данных зсЕВ. Для выбора другого ин- 
дексного регистра необходимо опять записать его код в порт ЗсЕЬ. 


Далее рассмотрим индексные регистры подробнее. 


4.3.2.1. Регистр ООВ 


Размер регистра равен 8 бит. Данный регистр управляет цветовыми плоско- 
стями, расположенными в видеопамяти. Биты с 0 по 3 представляют собой 
четыре плоскости. Эти биты используются режимами записи (см. разд. 4.3.2.6) 
под номерами 0 и 3. 


4.3.2.2. Регистр О1В 


Размер регистра равен 8 бит. Этот регистр позволяет включать или отклю- 
чать использование регистра о0ъ при работе с выбранной плоскостью. Биты 
с 0 по 3 представляют собой четыре плоскости в видеопамяти. Они исполь- 
зуются в нулевом режиме записи и позволяют выбирать тип операции: по- 
лучать ли данные для каждой плоскости от системы (процессора) или от 
установки соответствующего бита в индексном регистре оов. 


4.3.2.3. Регистр 021 


Размер регистра равен 8 бит. Данный режим сравнивает выбранный цвет в 
регистре с цветом в памяти и возвращает результат сравнения. Биты с 0 
по 3 представляют собой четыре плоскости, расположенные в видеопамяти. 
Процесс сравнения начинается с чтения (только в режиме чтения 1) значе- 
ния цвета, после чего считывается значение цвета из памяти. В результате, 
если бит в памяти и бит в регистре совпадают, результирующий бит ра- 
вен |, иначе 0. 


4.3.2.4. Регистр ОЗВ 


Размер регистра равен 8 бит. Он предназначен для выбора различных логи- 
ческих операций, применяемых к передаваемым от процессора данным, а 
также позволяет выполнять циклический сдвиг вправо передаваемых дан- 
ных. Логическая операция выполняется над данными и содержимым реги- 
стра-защелки. Формат регистра приведен в табл. 4.22. 


Приведем некоторые пояснения к таблице. 


С Биты 0—2 определяют целое значение, на которое будет выполнена ло- 
гическая операция сдвига вправо. Используется для режимов записи 0 
и 3. 
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О Биты 3 и 4 указывают на тип логической операции и могут принимать 
одно из следующих значений: 


00. — данные передаются без изменений; 
01. — данные преобразуются с помошью операции Амо; 
02. — данные преобразуются с помощью операции ов; 


03 — данные преобразуются с помошью операции хов. Данное поле 
применяется для режимов записи под номерами 0 и 2. 


Таблица 4.22. Формат индексного регистра 035 


Бит Описание 
0—2 Индекс сдвига 
3—4 — Тип логической операции 


4—7 Резерв 


4.3.2.5. Регистр О4В 


Размер регистра равен 8 бит. Предназначен для выбора плоскости в видео- 
памяти, которая будет использована в режиме чтения (номер 0) для получе- 
ния данных. Задействованы только 0 и | биты, с помощью которых выбира- 
ется номер плоскости (0—3). 


4.3.2.6. Регистр 05В 


Размер регистра равен 8 бит. Он предназначен для установки различных 
режимов работы. Формат регистра представлен в табл. 4.23. 


Таблица 4.23. Формат индексного регистра 055 


Бит Описание 
0—1 — Номер режима записи 
Резерв 


Номер режима чтения 


Режим чередования 


2 
З 
4 Адресация плоскостей 
5 
6 Режим цвета 

7 


Резерв 
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Приведем следующие пояснения к таблице. 


С Биты 0 и 1 позволяют выбрать режим записи. Существует четыре режима 
записи (от 0 до 3): 


» режим 0. Данные сначала сдвигаются в соответствии со значением 
индекса сдвига (регистр 035), далее выполняется операция установ- 
ки/сброса (регистр 001), а затем указанная логическая операция (ре- 
гистр 031). После этого данные помешаются в регистр-защелку, и там 
с помощью битовой маски (регистр 0о8ь) выбираются нужные биты, а 
затем окончательные битовые слои записываются в видеопамять в за- 
висимости от установки индексного регистра 026 синхронизатора; 


® режим 1. Данные передаются непосредственно из 32-битного регист- 
ра-защелки в видеопамять и зависят только от установки индексного 
регистра 025 синхронизатора; 


® режим 2. Биты 0—3 записываются в соответствующие плоскости ви- 
деопамяти. После этого в регистре-защелке выполняется указанная 
логическая операция, и данные обрабатываются с учетом битовой 
маски (регистр о8ь), а затем окончательные битовые слои записыва- 
ются в видеопамять в зависимости от установки индексного регистра 
02ь синхронизатора; | 


® режим 3. Данные обрабатываются, как если бы биты 3—0 регистра ой 
были установлены в | (11115). После этого выполняется операция 
сдвига в соответствии со значением индекса сдвига (регистр о3зь), а 
затем используется логическая операция Амр. Далее данные обрабаты- 
ваются с учетом битовой маски (регистр 085), а затем окончательные 
битовые слои записываются в видеопамять в зависимости от установ- 
ки индексного регистра 025 синхронизатора. 


С Бит 3 определяет один из возможных режимов чтения: 0 или |. В режиме 
чтения 0 байт считывается с одной из четырех плоскостей (0—3). Номер 
плоскости выбирается в регистре 04ь. В режиме чтения | выполняется 
сравнение цвета в видеопамяти с цветом, указанным в регистре о2н. Би- 
товые плоскости, игнорируемые в регистре 075, не сравниваются. В ре- 
зультате возвращается бит сравнения между цветом текущим и устанав- 
ливаемым. 


С Бит 4, установленный в 1, позволит выбирать нечетные адреса плоско- 
стей (1 или 3) для передаваемых от процессора данных, использующих 
нечетные адреса. 


С Бит 5, установленный в 1, позволит регистрам графического контроллера 
обрабатывать поток данных последовательно-параллельным способом: 
нечетные биты записываются в нечетные плоскости или четные биты за- 
писываются в четные битовые плоскости. 
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О Бит 6, установленный в 1, позволит включить поддержку 256-цветного 
режима. Установка бита в 0 позволит использовать только 16 цветов. 


4.3.2.7. Регистр ОбВ 


Размер регистра равен 8 бит. Он предназначен для установки различных 
параметров. Формат регистра представлен в табл. 4.24. 


Таблица 4.24. Формат индексного регистра обв 


Бит Описание 


0 Управление режимом 
1 Управление четностью 


2—3 — Выбор диапазона видеопамяти 


Приведем некоторые пояснения к таблице. 


С Бит 0, установленный в 1, включает графический режим, а запись 0 пе- 
реводит видеоадаптер в текстовый режим. 


О Бит 1, установленный в 1, позволит управлять четностью. При этом не- 
четные адреса будут записаны в нечетную плоскость, а четные — в чет- 
ную плоскость памяти. 


0 Биты 2—3 позволяют установить доступный видеоадаптеру диапазон па- 
мяти. Поддерживаются следующие значения: 005 — А00005—ВЕЕЕЕЬ 
(128 Кбайт), 01. — 2А0000н-—АРЕЕЕь (64 Кбайт), 02. — 8в00005-—В7ЕЕЕВ 
(32 Кбайт) и 03зв — в80005—ВЕЕЕЕН (32 Кбайт). 


4.3.2.8. Регистр 07Р 


Размер регистра равен 8 бит. Он позволяет игнорировать указанные цвето- 
вые плоскости. Для выбора нужной плоскости используются биты 0—3. 
Данный регистр используется для режима чтения 1. Установка любого бита 
указывает на то, что соответствующая плоскость будет рассмотрена при 
сравнении. Установка бита в 0 позволяет режиму чтения игнорировать ее. 


4.3.2.9. Регистр ОЗП 


Размер регистра равен 8 бит. Данный регистр (все 8 бит) используется в ре- 
жимах записи 0, 2 и 3. Он позволяет включить или отключить возможность 
изменения одного или всех битов в байте адресуемых данных. Значение ре- 
гистра влияет на все четыре плоскости. Если бит в регистре установлен в 1, 
значит, будет выбрано предыдущее значение бита. Если бит равен 0, будет 
использовано значение соответствующего бита из регистра-защелки. 
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Рассмотрим примеры работы с регистрами графического контроллера. Сна- 
чала получим значение диапазона памяти, используемой видеоконтролле- 
ром (листинг 4.33). 


: Листинг 4.33. Определение адреса выделенной памяти 








хог АБ, АБ ; обнуляем регистр 


поу АБ, 060 ; записываем значение регистра 061 
поу ОХ, ОЗСЕВ ; выбираем порт для записи 


оцЕ ОХ, АБ ; записываем значение в порт 
поу ОХ, ОЗСЕВ ; выбираем порт для чтения 

101 АБ, ОХ ; читаем байт из порта 

апа АБ, 011005; выделяем нужное значение 

стр АБ, 0 ; если АО000Б-ВЕЕЕЕР (128 Кбайт) 
)е МЕМ 128 

сир АБ, 1 ; если АО00ОП-АЕЕЕЕЬ (64 Кбайта) 
3е МЕМ 64 

стр АГ, 2 ; если В00006-В7ЕЕЕВ (32 Кбайта) 
9е МЕМ 32 

ср АБ, 3 ; если В8000\-ВЕЕРЕВ (32 Кбайта) 
Зе МЕМ 32 2 


Аналогичный пример для С++ будет выглядеть так, как показано в листин- 
ге 4.34. 


выделенной памяти в С++ 





РИОВР ЧмВезо1 = 0; // переменная для хранения результата 
// записываем значение регистра 06 в порт ОЗСЕБ 
опЕРохЕ (0х03СЕ, 0х06, 1); 
// читаем байт из порта ОЗСЕВ 
1пРоге ( ОхоЗСЕ, &амВезо1®, 1); 
// выделяем биты 2 и 3 
ЧмВези1е &= 0х0С; 
// сравниваем результат 
зм1ЕСП ( ЧмВезо1*) 
{ 
сазе 0: // АООООН-ВЕЕЕЕВ (128 Кбайт) 
Ьгеах; 
сазе 1: // АООООБ-АРЕЕЕБ (64 Кбайта) 
ргеак; 
сазе 2; // В00008-В7ЕРЕВ (32 Кбайта) 
ргеак; 
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сазе 3: // В80001-ВЕЕРЕВ (32 Кбайта) 
Ьхеак; 


Рассмотрим еще один пример, использующий регистр о4ь для выбора плос- 
кости под номером 1 (листинг 4.35). 


‚Листинг 4. 35. `Выбор п: плоскости в 3 видеопамяти. 


зещененини пенни иена иначе ву нии вии ль нев Ни ва анна нанавченанитананий 1 


хог АБ, АБ ; обнуляем регистр 

поу АБ, 04р ; записываем значение регистра 048 
поу ОХ, ОЗСЕВ; выбираем порт для записи 

оцЕ ОХ, АБ ; записываем значение в порт 

поу ОХ, ОЗСЕВ; выбираем порт для записи 

поу АБ, 016 ; плоскость номер 1 

оцЕ ОХ, АБ ; записываем значение в порт 


Аналогичный пример для С++ будет выглядеть так, как показано в листин- 
ге 4.36. 


Листинг 4.36. Выбор плоскости в видеопамяти для С++ 
ОИОВР ЯмВези1Е = 0; // переменная для хранения результата 

// записываем значение регистра 048 в порт ОЗСЕВ 

оцЕРохЕ (0х0ЗСЕ, 0х04, 1); 


// записываем плоскость номер 1 в порт ОЗСЕВ 
ОЦЕРОЕЕ (0хОЗСЕ, 0х01, 1); 


Приведу еше один пример использования регистров 00, и 015. Напишем 
код, который допускает использование только плоскости с номером 2 (лис- 
тинг 4.37). 





Листинг 4.37. Фиксация плоскости в видеопамяти 





хог АЦ, АБ ; обнуляем регистр 

поу АГ, Обр ; записываем значение регистра 001 
поу ОХ, ОЗСЕВ; выбираем порт для записи 

оцЕ ОХ, АБ ; записываем байт в порт 

поу ОХ, ОЗСЕН; выбираем порт для записи 

поу АГ, 001 ; обнуляем все 4 плоскости 

оц ОХ, АБ ; записываем байт в порт 

поу АБ, 010 ; записываем значение регистра 018 
шоу ОХ, ОЗСЕВ; выбираем порт для записи 

оцЕ ОХ, АБ ; записываем байт в порт 
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поу ОХ, ОЗСЕБ; выбираем порт для записи 
моу АБ, 01000; включаем плоскость номер 2 
опЕ ОХ, АБ ; Записываем байт в порт 


Поскольку значения портов ЗсЕБ и зсЕь отличаются на одну единицу, мож- 
но использовать (для ассемблера) команды 1пс И дес. Например, чтобы пе- 


редать данные в регистр о7ь, сделайте так, как показано в листинге 4.38. 


Листинг 4.38. Передача видеоданных 


поу АГ, ОТВ ; записываем значение регистра 078 
шоу ОХ, ОЗСЕВ; выбираем порт ОЗСЕВ 

опЕ ОХ, АБ ; записываем байт в порт 

11с БХ ; выбираем соседний порт ОЗСЕВ 

зп АБ, БХ ; читаем байт из порта 

дес ОХ ; выбираем опять порт ОЗСЕВ 

поу АГ, 07 ; записываем значение регистра 076 
опЕ ОХ, АБ ; записываем байт в порт 

11с ЭХ ; выбираем соседний порт ОЗСЕВ 

11 АБ, БХ ; читаем байт из порта 


Приведенный пример ничего не делает, кроме демонстрации удобного спо- 
соба выбора смежных портов. Далее в этой главе будет использоваться код с 
явным указанием всех портов, что делается исключительно для наглядности 
материала, но в своих программах читатель вправе выбирать наиболее удоб- 
ный для себя вариант. 


4.3.3. Регистры контроллера атрибутов 


Данные регистры управляют выбором палитры, цветом обрамляющей экран 
рамки, преобразованием байта атрибута в данные о цвете символа и фона, а 
также режимом прокрутки экрана. Для указания адреса используется порт 
зсов. Для передачи данных также применяется порт зсов. Для определения 
текущего режима порта зсов (адрес индекса или передача данных) следует 
прочитать порт зрАв. Кроме того, можно ориентироваться на цикл работы 
данного порта: первое обращение к порту указывает на номер индексного 
регистра, а второе — на передачу данных. При третьем обращении порт зсов 
опять ожидает номера индексного регистра. И так далее. Для считывания 
данных может применяться порт зс1в. Формат регистра зсоь показан в 
табл. 4.25. 


Приведем краткое описание таблицы. 


@ Биты 0—4 определяют номер индексного регистра, для которого должна 
быть выполнена операция чтения или записи. 
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О Бит 5, установленный в 1, закрывает доступ к внутренней палитре. Если 
бит установлен в 0, будет выполнена загрузка значений иветов во внут- 
ренние регистры палитры. 


Таблица 4.25. Формат регистра Зсов 


Бит Описание 


0—4 Номер индексного регистра 
5 Использование палитры 


6—7 Резерв 


Контроллер атрибутов поддерживает 20 индексных регистров (от оон до 143). 
Каждый индексный регистр отвечает за определенные настройки. Список 
индексных регистров показан в табл. 4.26. 


Таблица 4.26. Список индексных регистров контроллера атрибутов 


Код индексного 





регистра Описание 
00.—0ЕБ Регистры палитры 
108 Регистр управления режимом 
116 Регистр управления цветом рамки 
128 Регистр управления цветовыми плоскостями 
13в Регистр горизонтального панорамирования в единицах пиксела 
14В Регистр выбора цвета 


Рассмотрим подробнее индексные регистры контроллера атрибутов. 


4.3.3.1. Регистры палитры (00Н—ОЕВ) 


Размер каждого регистра равен 8 бит. Регистры палитры предназначены для 
динамического преобразования атрибута текстового символа или значения 
цвета (в графическом режиме) в реальный код цвета на экране. Использу- 
ются только биты с 0 по 5. При установке бита в | будет выбран соответст- 
вующий цвет. Изменять значения внутренних регистров палитры можно 
только во время обратного хода луча по вертикали, иначе возникнут про- 
блемы с выводимым на экран изображением. 


4.3.3.2. Регистр ТОВ 


Размер регистра равен 8 бит. Он предназначен для установки различных 
режимов работы. Формат регистра показан в табл. 4.27. 
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Таблица 4.27. Формаг регистра управления режимом (105) 


Бит Описание 

0 Управление графическим режимом 

1 Эмуляция монохромного дисплея 
Использование псевдографики 
Управление миганием символа 
Резерв 
Режим поэлементного панорамирования 


Управление цветом 


чо аъ оъ 


Управление регистрами палитры 


Приведем краткие пояснения к таблице. 


| 


| 


Бит 0, установленный в 1, позволяет выбрать графический режим ра- 
боты. 


Бит 1, установленный в 1, позволяет выбрать монохромный режим ра- 
боты дисплея. Если бит установлен в 0, будет использоваться цветной 
режим. 


Бит 2 применяется в 9-разрядных символьных режимах для того, чтобы 
правильно отобразить непрерывную строку символов. При установке би- 
та в | каждый 9-й столбец будет закрашен фоновым цветом остальных 
символов. 


Бит 3, установленный в 1, разрешает мигание символа. Если этот бит 
равен 0, используется насыщенность ивета фона символа (7 бит байта 
атрибута). 


Бит 5, установленный в 1, разрешает использование режима поэлемент- 
ного панорамирования. 


Бит 6, установленный в 1, позволяет выбрать 8-битный цвет (256 иветов). 
Во всех остальных режимах этот бит должен быть установлен в 0. 


Бит 7, установленный в 1, позволяет использовать биты 4 и 5 регистра 
палитры вместо битов 0 и 1 регистра выбора цвета (145). 


4.3.3.3. Регистр 11В 


Размер регистра равен 8 бит. Он предназначен для установки цвета обрам- 
ляющей экран рамки. Используются все биты. Для установки цвета следует 
записать в этот регистр номер одного из регистров ЦАП (005—ЕЕВ). 
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4.3.3.4. Регистр 128 


Размер регистра равен 8 бит. Он позволяет устанавливать доступ к опреде- 
ленным цветовым плоскостям. Используются биты с 0 по 3. Установка в 1 
какого-либо из этих битов, позволит открыть доступ к плоскости памяти, 
имеющей соответствующий номер (от 0 до 3). 


4.3.3.5. Регистр 131 


Размер регистра равен 8 бит. Он позволяет управлять горизонтальным па- 
норамированием (сдвигом по горизонтали вправо) и используется битовое 
поле с 0 по 3. Для указания нового значения следует записать в это поле 
целое число, измеряемое в пикселах. Сдвиг может применяться в текстовых 
и графических режимах. Запись в регистр нужно производить в момент об- 
ратного хода луча по вертикали. 


4.3.3.6. Регистр 14В 


Размер регистра равен 8 бит. Он позволяет расширить 6-разрядные значе- 
ния цвета до 8-разрядных, а также заместить биты 4 и 5 регистров палитры. 
Формат регистра показан в табл. 4.28. 


Таблица 4.28. Формат регистра управления режимом (145) 


Бит Описание 


0—1 — Замещение 4 и 5 битов регистров палитры 
2—3 — Добавление 6 и 7 битов описания цвета 


4-7 Резерв 


Приведем краткое описание таблицы. 


О Биты 0 и 1 управляют замещением 4 и 5 битов регистра палитры. Если в 
регистре управления режимом (101) бит 7 установлен в 1, то 4 и 5 биты 
во всех регистрах палитры будут замещены 0 и 1 битом регистра выбора 
цвета. 


О Биты 2 и 3 позволяют добавить два старших бита (6 и 7) к 5-разрядному 
представлению цвета для согласования с регистром цвета ЦАП. Этот ре- 
жим может использоваться для быстрого переключения цветов ЦАП. 


Рассмотрим пример работы с регистрами контроллера атрибутов. Попробу- 
ем установить графический режим работы с помощью регистра управления 
режимом (105), как показано в листинге 4.39. 
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хог АГ, АБ ; обнуляем регистр 

поу АБ, 101 ; записываем значение регистра 108 
поу ОХ, ОЗСОР; выбираем порт для записи индекса 
оц ОХ, АБ ; записываем значение в порт 

пох ОХ, 03006; выбираем порт для записи индекса 
20 В, ОХ ; читаем из порта ЗСОВ 

хог ВЫ, ВЫ ; обнуляем регистр 

апа ВЬ, 016 ; устанавливаем графический режим 
поу АБ, 101 ; записываем значение регистра 108 
поу ОХ, 03СОР; выбираем порт для записи индекса 
ое ОХ, АБ ; записываем значение в порт 

шоу ОХ, ОЗСОР; выбираем порт для записи индекса 
опЕ ПОХ, АБ ; записываем значение в порт 

поУу АГ, ВЬ ; копируем значение 

оцЕ ОХ, АБ ; записываем значение в порт 


Приведенный выше пример сознательно упрощен для лучшего понимания 
работы с контроллером атрибутов. Аналогичный пример для С+- показан 
в листинге 4.40. 


Листинг 4.40. Установка графического режима работы в С++ 





// переменная для хранения результата 

РИОВР ЧмВезо1Е = 0; 

// записываем значение регистра 10, в порт 03С08 
ооЕРогЕ (0х03С0, 0х10, 1); 

// читаем из порта ЗС0в 

1пРоге ( 0х03С0, &АмВезо]1е, 1}; 

// устанавливаем графический режим 

ФЧ\Везо16 &= 0х01; 

// записываем значение регистра 10 в порт 03С08 
очЕРоге (0х03С0, 0х10, 1); 

// записываем новое значение 

опЕРоге (0х03С0, амВезы1+, 1); 


4.3.4. Регистры контроллера САТ 


Контроллер катодно-лучевой трубки управляет кадровой разверткой (фор- 
мированием кадров на дисплее), а также параметрами горизонтальной раз- 
вертки. Для доступа к контроллеру СЕТ используются два основных порта: 
выбора адреса (порт зрав) и ввода-вывода данных (порт 3555). Кроме этого, 
контроллер поддерживает 25 индексных регистров, управляющих различ- 
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ными функциями контроллера СВТ. Полный список этих регистров приве- 
ден в табл. 4.29. Для записи или чтения данных в порт зран следует записать 
номер индексного регистра, а затем передать или получить данные через 
порт 3958. 


Таблица 4.29. Список индексных регистров контроллера СВТ 





Код индексного 





регистра Описание 
00в Регистр полной длины горизонтальной развертки 
018 Регистр длины горизонтальной развертки 
028 Начало хода луча по горизонтали 
ЗВ Конец хода луча по горизонтали 
04в Начало обратного хода луча по горизонтали 
058 Конец обратного хода луча по горизонтали 
06в Количество линий растра экрана или длина вертикального хода 
луча 
078 Регистр переполнения 
о8В Регистр предварительной развертки по горизонтали 
ов Максимальная высота строки развертки 
ОАВ Регистр начальной позиции курсора 
ОвВ Регистр конечной позиции курсора 
осв Старший байт в начальном адресе 
орь Младший байт в начальном адресе 
ОЕВ Старший байт в позиции курсора 
ОЕЬ Младший байт в позиции курсора 
108 Начало обратного хода луча по вертикали 
11 Конец обратного хода луча по вертикали 
12в Количество линий в растре 
13в Регистр смещения 
14в Позиция символа подчеркивания 
158 Начало хода луча по вертикали 
165 Конец хода луча по вертикали 
178 Регистр управления режимом 


185 Регистр сравнения строк 
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Работать с регистрами СВТ следует очень осторожно, чтобы не повредить 
монитор. Для защиты регистров 001—075 от записи в регистре 11н бит 7 все- 
гда установлен в 1. Чтобы восстановить возможность записи, следует обну- 
лить этот бит. 


4.3.4.1. Регистр О0В 


Размер регистра равен 8 бит. Он предназначен для определения полного 
размера горизонтальной развертки. Позволяет управлять частотой обновле- 
ния экрана по горизонтали, устанавливая необходимое для этого количество 
времени. 


4.3.4.2. Регистр 01В 


Размер регистра равен 8 бит. Он предназначен для управления длиной гори- 
зонтальной развертки, отображаемой на экране. Данный регистр устанавли- 
вает порядок вывода на экран значений пикселов из памяти дисплея. Нача- 
ло вывода устанавливается количеством кодовых комбинаций активного 
дисплея минус один. 


4.3.4.3. Регистр 021 


Размер регистра равен 8 бит. Он предназначен для управления началом мо- 
мента гашения луча по горизонтали. Данный регистр используется совмест- 
но с регистром озь для получения точки гашения луча по горизонтали. 


4.3.4.4. Регистр ОЗВ 


Размер регистра равен 8 бит. Он предназначен для управления окончатель- 
ным моментом гашения луча по горизонтали. Формат регистра показан в 
табл. 4.30. 


Таблица 4.30. Формат регистра 03н 


Бит Описание 
0—4 — Указывает на конец гашения луча 
5—6 Определяет количество импульсов задержки (как правило, равно 0) 


7 Используется для поддержки светового пера (оставлено ради совместимости) 


4.3.4.5. Регистр 048 


Размер регистра равен 8 бит. Он позволяет управлять началом обратного 
хода луча по горизонтали. Значение этого регистра определяет временной 
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интервал, через который начнется передача синхронизирующих импульсов 
дисплею. Регистр используется совместно с регистром 055. 
4.3.4.6. Регистр 05 


Размер регистра равен 8 бит. Он предназначен для управления окончатель- 
ным моментом ‘гашения луча по горизонтали. Формат регистра показан в 
табл. 4.31. 


Таблица 4.31. Формат регистра 055 


Бит Описание 


0—4 — Указывает на конец обратного хода луча 
5—6 — Определяет время задержки (как правило, равно 0} 


7 Содержит 5 бит дополнительно к битам 0—4 


4.3.4.7. Регистр О6В 


Размер регистра 10 битов. Старшие два бита (8 и 9) располагаются в регист- 
ре переполнения (07.). Регистр определяет количество вертикальных линий 
растра для активного экрана, иначе говоря, управляет значением длины об- 
ратного хода луча по вертикали. 


4.3.4.8. Регистр 07В 


Размер регистра равен 8 бит. Он предоставляет дополнительные биты для 
различных управляющих регистров. Формат данного регистра показан в 
табл. 4.32. 


Таблица 4.32. Формат регистра 078 


Бит Описание 


© 


Бит 8 для регистра обв 
Бит 8 для регистра 125 
Бит 8 для регистра 106 
Бит 8 для регистра 155 
Бит 8 для регистра 18ъ 
Бит 9 для регистра обв 


Бит 9 для регистра 125 


хо ало т -—ё 


Бит 9 для регистра 108 
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4.3.4.9. Регистр ОЗР 


Размер регистра равен 8 бит. Он позволяет настроить горизонтальную раз- 
вертку. Кроме того, данный регистр позволяет в текстовом режиме органи- 
зовать плавную прокрутку экрана. Формат регистра представлен в табл. 4.33. 


Таблица 4.33. Формат регистра о8ь 


Бит Описание 


0—4 — Количество линий вертикальной развертки 
5—6 — Управление позицией левого верхнего угла в видеопамяти 


7 Резерв 


Приведем краткое пояснение к таблице. 


О Биты 0—4 содержат количество линий горизонтальной развертки, на ко- 
торое экран должен быть прокручен вверх. Возможные значения должны 
лежать в диапазоне от 0 до максимальной высоты строки развертки 
(см. разд. 4.3.4. 10). 


О Биты 5—6 используются совместно с регистрами начального адреса для 
получения координат левого верхнего пиксела или символа на экране. 


4.3.4.10. Регистр ЭР 


Размер регистра равен 8 бит. Он предназначен для управления высотой 
строки развертки. Кроме этого, регистр содержит дополнительные биты для 
некоторых других регистров. Формат данного регистра показан в табл. 4.34. 


Таблица 4.34. Формат регистра 095 


Бит Описание 





0—4 — Максимальная высота строки развертки 


5 Бит 9 для регистра 15ь 
6 Бит 9 для регистра 18ь 
7 Режим двойного сканирования 





Приведем краткое описание таблицы. 


О Биты 0—4 определяют максимальное значение высоты одной строки раз- 
вертки, иначе говоря, высоту символов на экране дисплея. 


О Бит 5 определяет дополнительный старший (бит 9) разряд для регист- 
ра 155. 
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О Бит 6 определяет дополнительный старший (бит 9) разряд для регист- 
ра 185. 


О Бит 7 управляет режимом двойного сканирования. При установке этого 
бита в ! будут использоваться 400 линий. Если бит установлен в 0, то 
200 линий. 


4.3.4.11. Регистр ОАР 


Размер регистра равен 8 бит. Он предназначен для управления начальной 
позицией курсора на экране. Формат регистра показан в табл. 4.35. Исполь- 
зуется для текстового режима. 


Таблица 4.35. Формат регистра оАН 


Бит Описание 
0—4 Начальная позиция линии курсора 
5 Управление курсором 


6—7 Резерв 


Приведем краткий комментарий к таблице. 


О Биты 0—4 содержат значение позиции для линии развертки, на которой 
будет расположен курсор. 


О Бит 5 управляет отображением курсора в текстовом режиме. Установка 
этого бита в 1 скрывает курсор с экрана. 


4.3.4.12. Регистр ОВ 


Размер регистра равен 8 бит. Он предназначен для управления конечной 
позицией курсора на экране. Формат регистра показан в табл. 4.36. Регистр 
используется для текстового режима. 


Таблица 4.36. Формат регистра овь 


Бит Описание 


0—4 — Конечная позиция линии курсора 
5—6 — Смещение курсора 
7 Резерв 


Приведем краткое описание таблицы. 


О Биты 0—4 содержат значение позиции для линии развертки, на которой 
будет расположен курсор. 
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О Биты 5—6 используются в режиме ЕСА для синхронизации курсора с 
работой дисплея. В режиме УСА могут быть установлены в ноль или до- 
полнять биты 0—4. 


4.3.4.13. Регистр ОСВ 


Размер регистра равен 8 бит. Он содержит значение старшего байта (би- 
ты 8—15) начального адреса в видеопамяти, используемого для вывода 
информации на экран. Проще говоря, данный регистр содержит старшую 
часть адреса, которая определяет начальную позицию (левый верхний угол) 
на экране. 


4.3.4.14. Регистр ОБН 


Размер регистра равен 8 бит. Он содержит значение младшего байта (би- 
ты 0—7) начального адреса в видеопамяти, используемого для вывода ин- 
формации на экран. Совместно с регистром ось он определяет полный 
16-битный адрес начальной позиции (левый верхний угол) на экране. По- 
скольку размер адресуемой памяти ограничен (только 16 разрядов), данные 
регистры могут применяться только для текстовых и для некоторых графи- 
ческих режимов. 


4.3.4.15. Регистр ОЕВ 


Размер регистра равен 8 бит. Он содержит значение старшего байта (би- 
ты 8—15) позиции курсора на экране. 


4.3.4.16. Регистр ОРЛ 


Размер регистра равен 8 бит. Он содержит значение младшего байта (би- 
ты 0—7) позиции курсора на экране. Совместно с регистром оЕВ он опреде- 
ляет позицию курсора на экране относительно левого верхнего угла. Оба 
регистра используются в текстовых режимах. 


4.3.4.17. Регистр 108 


Размер регистра равен 10 битов. Два старших бита (8 и 9) расположены 
в регистре переполнения (071). Он предназначен для управления начальным 
значением обратного хода луча по вертикали. 


4.3.4.18. Регистр 711В 


Размер регистра равен 8 бит. Он предназначен для управления конечным 
значением обратного хода луча по вертикали. Кроме этого, регистр позво- 
ляет блокировать запись в регистры 00,—071. Формат регистра показан в 
табл. 4.37. 
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Таблица 4.37. Формат регистра 1115 


Бит Описание 


0—3 — Обратный ход луча по вертикали 


4—5 Резерв 
6 Обновление памяти 
7 Блокировка регистров 00*—075 


Приведем краткие пояснения к таблице. 
О Биты 0—3 определяют значение обратного хода луча по вертикали. 


О Бит 6 управляет количеством циклов обновлений (регенерации) динами- 
ческой памяти за время вертикального хода луча. Возможны 2 значения: 
3 цикла (31,5 кГц), если бит равен 0, и 5 циклов (15,7 кГц), если бит ра- 
вен [. 


С Бит 7 используется для защиты регистров 00—07. Если бит установлен 
в |, запись вышеуказанных регистров будет невозможна, за исключением 
бита 4 регистра переполнения (075). 


4.3.4.19. Регистр 128 


Размер регистра равен 10 бит. Два старших бита (8 и 9) расположены в ре- 
гистре переполнения (07.)}. Регистр содержит количество вертикальных ли- 
ний в растре минус один для активного экрана. 


4.3.4.20. Регистр 13Р 


Размер регистра равен 8 бит. Он определяет смещение для ширины логиче- 
ского экрана в памяти. Для текстовых режимов значение данного регистра 
равно ширине экрана (в пикселах), деленной на двойной размер памяти. 
Для графических режимов смещение равно ширине экрана (в пикселах), 
деленной на произведение двойного размера памяти и количества пикселов 
в одном адресе памяти. Данный регистр позволяет создать виртуальный эк- 
ран, превышающий физический размер. 


4.3.4.21. Регистр 14Р 


Размер регистра равен 8 бит. Он предназначен для управления символом 
подчеркивания. Формат регистра показан в табл. 4.38. 


Приведем краткое описание таблицы. 


С Биты 0—4 определяют позицию на горизонтальной строке развертки ми- 
нус [. 
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С Бит 5, установленный в 1, позволяет синхронизировать значение счетчи- 
ка импульсов со значением синхроимпульсов, деленным на 4. 


О Бит 6, установленный в [, позволит использовать для адресации памяти 
двойные слова (32 бита). 


Таблица 4.38. Формат регистра 145 


Бит Описание 

0—4 Позиция подчеркивания 
Счетчик 
Множитель 


Резерв 


4.3.4.22. Регистр 15Р 


Размер регистра равен 10 бит. Бит 8 расположен в регистре 07п, а бит 9 — 
°в регистре оэь (бит 5). Этот регистр позволяет управлять значением 
начального хода луча по вертикали. 


4.3.4.23. Регистр 16Ъ 


Размер регистра равен 8 бит, но используются только биты с 0 по 6. Он по- 
зволяет управлять значением конечного хода луча по вертикали. 


4.3.4.24. Регистр 17Р 


Размер регистра равен 8 бит. Он предназначен для управления различными 
режимами работы. Формат регистра показан в табл. 4.39. 


Таблица 4.39. Формат регистра 171 


Бит Описание 

Управление мультиплексором 
Управление мультиплексором 
Вертикальная синхронизация 
Использование счетчика адреса 
Резерв 

Выбор адресов 


Режим адресации 


чото т - о 


Управление синхронизацией 
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Приведем краткие пояснения к таблице. 


С Бит 0 управляет битом 13 мультиплексора контроллера СВТ. Если бит 
установлен в 1, будет выбран счетчик адресов. Бит применяется для под- 
держки более старых контроллеров. 


С Бит [| управляет битом 14 мультиплексора контроллера СВТ. Если бит 
установлен в [, будет выбран счетчик развертки по горизонтали. 


С Бит 2 управляет вертикальной синхронизацией. Если бит установлен в 1, 
горизонтальные синхроимпульсы делятся на два, что позволяет удвоить 
разрешение по вертикали. 


С Бит 3, установленный в 1, приводит к тому, что счетчик адресов делит на 
два входные кодовые импульсы символов. 


С Бит 5 позволяет управлять битами адресов 13 и 15. Он используется для 
совместимости с некоторыми типами мониторов. 


0 Бит 6 позволяет установить желаемый режим адресации: байтами или 
словами. При установке этого бита в 0 будет использоваться адресация 
словами. 


С Бит 7, установленный в 0, позволяет блокировать горизонтальные и вер- 
тикальные сигналы для обратного хода луча. 


4.3.4.25. Регистр 18В 


Размер регистра равен 19 бит. Дополнительные биты 8 и 9 расположены в 
регистрах о7ь и 09, соответственно. Регистр определяет разделяющую стро- 
ку развертки по горизонтали. 

* * * 


На этом можно завершить описание регистров СВТ. Рассмотрим простой 
пример доступа к регистру одь для удаления курсора с экрана (лис- 
тинг 4.41). 


Листинг 4.41. Удаление курсора с экрана _ 


хог АБ, АБ ; обнуляем регистр 





поу АЬ, ОАВ ; записываем значение регистра ОАБ 
поу ОХ, 03041; выбираем порт для записи индекса 
оц ОХ, АБ ; записываем значение в порт 

хог ВЬ, ВЬ ; обнуляем регистр 


поу ОХ, 03051; выбираем порт для записи индекса 
Ш ВБ, БХ ; читаем из порта 3050 

$езЕ ВЬ, 20. ; если курсор уже скрыт 

}е ЕМЬ РВОС ; выходим из процедуры 

апЯ В, 20.0 ; отключаем курсор 
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поу АБ, ОАВ ; записываем значение регистра ОАБ 
по\у БХх, 0341; выбираем порт для записи индекса 
оцё ПХ, АБ ; записываем значение в порт 

поу ОХ, 03051; выбираем порт для записи индекса 
поу АГ, ВЬ ; копируем байт 

оце БХ, АБ ; записываем значение в порт 


Аналогичный пример для С++ представлен в листинге 4.42. 





Листинг 4.42. Удаление курсора с экрана в С++ 





// переменная для хранения результата 
ОИОВО амВези1Е = 0; 
// записываем значение регистра ОАВ в порт 03148 
очЕРог® (0х0304, ОхоА, 1); 
// читаем из порта 3058 
1пРоге ( 0х03р5, &амВези1%, 1); 
// если курсор уже скрыт, выходим из процедуры 
1Е ( ( амВезо1е & 0х20) == 1) 
тебиагп; 
// отключаем курсор 
ЧмВези1Е &= 0х20; 
// записываем значение регистра ОАБ в порт 03048 
оиЕРогЕ (0х03р4, ОхоА, 1); 
// записываем новое значение 
оиЕРогЕ (0х0305, АмВези1, 1); 


Большинство из описываемых регистров СКТ используются попарно (на- 
пример, регистры ось и орв или ОЕВ и ОЕК). 


4.3.5. Регистры ЦАП 


Регистры ЦАН предназначены для преобразования цифровых данных, по- 
ступающих с видеоконтроллера, в аналоговый сигнал, который поступает на 
экран дисплея. ЦАП поддерживает 256 регистров (256 цветовых оттенков 
одновременно), каждый из которых содержит по три значения уровней для 
трех основных цветов: красного, зеленого и синего. Размер каждого регист- 
ра равен 18 бит (по 6 битов на каждый цвет). Значение каждого цвета может 
лежать в диапазоне от 0 до 63 единиц. Для доступа к регистрам ЦАП ис- 
пользуются три порта: 


1. Порт зс7ь в режиме записи управляет адресным регистром, а в режиме 
чтения считывает текущее состояние ЦАП. 
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2. Порт зс8» позволяет в режиме записи указать номер регистра таблицы 
цветов, а в режиме чтения возвращает текущий номер регистра таблицы 
цветов. 


3. Порт зс9в в режиме записи позволяет установить новое значение цвета 
для выбранного регистра таблицы цветов, а в режиме чтения считывает 
текущее значение цвета из указанного регистра цветов. 


Для записи нового значения цвета требуется выполнить подряд три опера- 
ции, по одной на каждую составляющую цвета (красный, зеленый, синий). 
После выполнения третьей операции индекс текушего регистра будет авто- 
матически увеличен на единицу, что упрощает запись всей таблицы цветов 
для 256 регистров. Рекомендуется перед записью или чтением регистров 
ЦАП отключать прерывания. 


Для записи новых значений цветов вначале следует записать в порт зс8ь 
номер регистра таблицы цветов (от 0 до 256). После этого в регистр данных 
{порт зс95) записываются последовательно три значения оттенка цвета, по 
одному на каждый основной цвет (красный, зеленый, синий). Регистр адре- 
са (зс8в) увеличивает номер индекса на |, и можно сразу продолжить за- 
пись трех составляющих цвета в следующий регистр таблицы цветов. Учи- 
тывая эту особенность, имеет смысл за одну операцию записи установить 
новые значения цветов для всей таблицы (256 регистров). Запись значений 
палитры цветов необходимо выполнять во время обратного хода луча. Рас- 
смотрим основные регистры ЦАЙ подробнее. 


4.3.5.1. Регистр 3С7В 


Размер регистра равен 8 бит. В режиме чтения используются только 0 и 
| биты. Формат регистра в режиме записи показан в табл. 4.40, а в режиме 
чтения — в табл. 4.41. 


Таблица 4.40. Формат регистра зс7Н (запись) 


Бит Описание 


0—7 — Номер регистра таблицы цветов (0—256) 


Таблица 4.41. Формат регистра зС7Ь (чтение) 


Бит Описание 


0—1 Состояние 


2—7 Резерв 


В режиме чтения биты 0—1 определяют текущее состояние ЦАП: 0 — ЦАП 
находится в режиме чтения, 3 — ЦАП находится в режиме записи. 
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4.3.5.2. Регистр ЗС8В 


Размер регистра равен 8 бит. Он используется для записи номера регистра 
палитры, для которого будут устанавливаться новые значения цветовых от- 
тенков. В режиме чтения может вернуть текущий номер регистра палитры. 


4.3.5.3. Регистр ЗСЭВ 


Размер регистра равен 8 бит, но используются только младшие 6 разрядов. 
Он применяется для записи или чтения значения цвета из выбранного реги- 
стра палитры. Операция чтения или записи выполняется три раза: для крас- 
ного, зеленого и синего цветов. Формат регистра в режиме записи показан 
в табл. 4.42. 


Таблица 4.42. Формат регистра ЗСЭВ (чтение и запись} 


Бит Описание 


0—5 Значение цвета 


6—7 Резерв 


Существует еще один регистр, адресуемый через порт зсбв. Он используется 
для маскирования значения цвета в одном из регистров таблицы цветов и 
доступен для записи и считывания. Но умолчанию значение в порту равно 
ЕВ. При обращении‘к регистру будет выполнена операция АМЬ между со- 
держимым этого регистра и значением выбранного регистра таблицы цве- 
тов. Не рекомендуется писать в порт зс6ь, поскольку это может привести 
к разрушению таблицы цветов. 


4.3.6. Регистры синхронизатора 


Регистры синхронизатора управляют подстройкой данных, передаваемых 
ЦАП, а также позволяют корректировать работу цепей синхронизатора для 
программирования нестандартных видеорежимов. Вся работа с цепями син- 
хронизатора построена на двух регистрах: на адресном (порт зсан} и на ре- 
гистре данных (порт 3с5в). Они позволяют получить доступ к пяти (905— 
04з) индексным регистрам. Перед началом работы следует записать в адрес- 
ный регистр (3с4ъ) номер индексного регистра, а затем можно считывать 
или записывать данные через порт зс5ъ. Рассмотрим индексные регистры 
подробнее. 


4.3.6.1. Регистр ООВ 


Размер регистра равен 8 бит, но используются только младшие два бита 
(0 и 1). Регистр управляет режимом сброса цепей синхронизации. Формат 
регистра показан в табл. 4.43. 
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Бит 


2—7 
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Таблица 4.43. Формат регистра 00, 


Описание 
Асинхронный сброс 
Синхронный сброс 


Резерв 


Приведем краткое описание таблицы. 


С Бит 0, установленный в 0, позволяет выполнить асинхронный сброс це- 
пей синхронизатора и остановить отправление синхроимпульсов. Для 
восстановления работы необходимо установить бит в 1. 


С Бит 1, установленный в 0, позволяет выполнить синхронный сброс цепей 
синхронизатора и остановить отправление синхроимпульсов. Для восста- 
новления работы необходимо установить бит в 1. 


4.3.6.2. Регистр 01Р 


Размер регистра равен 8 бит. Он предназначен для управления режимом 
синхронизации. Формат регистра представлен в табл. 4.44. 


Таблица 4.44. Формат регистра 015 


Описание 


Размер символов 

Резерв 

Частота преобразования 

Частота обновления 

Управление частотой преобразования 
Блокировка дисплея 


Резерв 


Приведем краткое пояснение к таблице. 


С Бит 0 позволяет установить размер символов. Возможны два значения: 
8 точек (бит равен 1) и 9 точек (бит равен 0). Изменение размера симво- 
ла может понадобиться при переключении текстовых режимов работы. 


С Бит 2, установленный вместе с битом 4 в 0, определяет, что преобразова- 
ние данных в выходных цепях происходит при каждом синхроимпульсе, 


иначе — через один. 
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С Бит 3, установленный в 0, определяет, что частота обновления точки 
(или символа} совпадает с частотой тактового генератора. Если бит равен |, 
частота обновления будет уменьшена в 2 раза. Изменение частоты по- 
влияет на все синхронизирующие импульсы, используемые в устройстве. 


С Бит 4, установленный в 1, уменьшает частоту преобразования данных 
в 4 раза. 


С Бит 5, установленный в 1, позволит выключить дисплей (блокировать 
передаваемые из видеопамяти данные). Может использоваться для пол- 
ноэкранных модификаций изображения. 


4.3.6.3. Регистр 02Р 


Размер регистра равен 8 бит. Используются младшие четыре бита (0—3). 
Регистр позволяет блокировать до четырех плоскостей видеопамяти (0—3). 
Установка бита в | разрешает запись в соответствующую плоскость. 


4.3.6.4. Регистр ОЗБ 


Размер регистра равен 8 бит. Он предназначен для выбора шрифта. Формат 
регистра приведен в табл. 4.45. 
Таблица 4.45. Формат регистра 03ь 
Бит — Описание 
0—1 Шрифт В 
2—3 Шрифт А 


4 Выбор символа из шрифта В 
5 Выбор символа из шрифта А 
6—7 Резерв 


Приведем краткое пояснение к таблице. 


СП Биты 0—1 позволяют выбрать шрифт В, если бит 3 атрибута символа 
установлен в 0. 


С Биты 2—3 позволяют выбрать шрифт А, если бит 3 атрибута символа 
установлен в 1. Адрес шрифта в памяти имеет следующие значения: 0005 — 
00005—1ЕЕЕЪ, 001Ъ — 40001—5ЕЕЕБ, 010Ъ — 80001—9ЭЕЕЕБ, 011Ъ — с0008— 
ОЕЕЕЪ, 1006 — 2000.—ЗЕЕЕЪ, 1016 — 6000. —7ЕЕЕЪ, 1105 — АОО0В—ВЕЕЕЪ. 


С Бит 4 определяет бит 2 для поля шрифта В. 
С Бит 5 определяет бит 2 для поля шрифта А. 
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4.3.6.5. Регистр 04Р 


Размер регистра равен 8 бит. Он позволяет управлять режимом работы ви- 
деопамяти. Формат регистра показан в табл. 4.46. 


Таблица 4.46. Формат регистра 045 


Бит Описание 


0 Резерв 

1 Расширенная память 

2 Выбор адресов 

З Управление операциями чтения 


4—7 Резерв 


Приведем краткое описание таблицы. 


С Бит [, установленный в |1, позволяет расширить объем адресуемой памя- 
ти от 64 до 256 Кбайт.. 


0 Бит 2 управляет доступом к четным и нечетным плоскостям в памяти. 
При установке бита в 0 четные адреса работают с плоскостями 0 и 2, 
а нечетные — с|1иЗ3. 


О Бит 3, установленный. в 0, позволяет последовательно считывать адре- 
суемые данные из памяти. 


Рассмотрим упрошенный пример работы с регистрами синхронизатора для 
выполнения синхронного сброса (листинг 4.43). 


хог АП, ; обнуляем регистр 








поу АГ, Обр ; записываем значение регистра 001 
оп ВХ, 
шоу ОХ, 
поу АГ, 


; записываем значение в порт 


А 
0 

поу ОХ, ОЗС4Н; выбираем порт для записи индекса 
АБ 
03С5р; выбираем порт для записи данных 
1 


; синхронный сброс 





сие ПОХ, АБ ; записываем значение в порт 

; восстанавливаем синхронизацию 

поу АБ, ООбн ; записываем значение регистра 008 

шоу ОХ, 03С4В; выбираем порт для записи индекса 

опЕ ОХ, АБ ; записываем значение в порт 

поу ОХ, ОЗС5Р; выбираем порт для записи данных 

поу АШ, 3 ; восстанавливаем сигнал синхронизации 





оц ОХ, АБ ; записываем значение в порт 
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Аналогичный пример для С++ показан в листинге 4.44. 





: Листинг 4.44. Выполнение синхронного сброса в С++ 


: 





// переменная для хранения результата 

ОМОВР ЯмВези1Е = 0; 

// записываем значение регистра ООП в порт 03С4В 
оаёРогЕ (0х03С4, 0х00, 1); 

// синхронный сброс 

опЕРоге {(0х03С5, 0х01, 1); 

// восстанавливаем синхронизацию 

// записываем значение регистра 00 в порт 03С4п 
опЕРогЕ (0х03С4, 0х00, 1); 

// восстанавливаем сигнал синхронизации 

опЕРоге (0х03С5, 0х03, 1); 


На этом примере можно завершить программирование видеоконтроллера 
с использованием аппаратных портов и перейти к рассмотрению возможно- 
стей интерфейса \/т32 АРТ для работы с видеоадаптером и монитором. 


4.4. Использование \/т32 АР] 


Программисту, работающему с интерфейсом \/т32, практически не нужно 
думать о непосредственном взаимодействии с видеоконтроллером и мони- 
тором. Интерфейс предоставляет универсальные законченные решения для 
вывода графической и текстовой информации на экран. Этих возможностей 
вполне достаточно для разработки большинства пользовательских программ. 
Даже для написания игровых приложений существуют дополнительные 
библиотеки (например, ОшесХ), которые в тандеме с функциями \/!132 
АР позволяют решить практически любые задачи. При этом скорость рабо- 
ты таких программ остается достаточно высокой, а если учесть мощь совре- 
менных процессоров (в том числе и графических), то вполне понятно, по- 
чему разработчики предпочитают стандартные библиотеки \\!!32 АР] непо- 
средственному программированию аппаратных портов. 


Здесь мы не будем изучать программирование графики в У/т4о\5$, а рас- 
смотрим только возможности управления видеоконтроллером и монитором, 
любезно "сохраненные" фирмой М!сгозой для разработчиков программного 
обеспечения: 


1. Управление графическими режимами. 
2. Получение информации о возможностях видеоконтроллера. 


3. Управление монитором в УЛп9о\%5. 
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4.4.1. Управление графическими режимами 


В Ушао\з существует возможность программно установить любой поддер- 
живаемый видеоадаптером режим работы. Для этого сначала нужно полу- 
чить список всех поддерживаемых режимов, а затем активизировать его. 
Сразу хочу заметить, что видеоадаптер, как правило, поддерживает гораздо 
больше режимов, чем установленный монитор, поэтому важно перед уста- 
новкой нового режима точно знать, будет ли с ним работать монитор. Иг- 
норирование этого правила может привести даже к выходу из строя мони- 
тора. Программист обычно не может заранее знать аппаратную конфигура- 
цию потенциального пользователя, поэтому вся ответственность выбора 
графического режима ложится на пользователя. Однако рекомендую про- 
граммистам перед установкой нового режима выводить предупреждающие 
сообщения, активизировать новый режим на несколько секунд (10—20), по- 
сле чего возвращаться к предыдущему. Это позволит уберечь начинающего 
пользователя от грубых ошибок и добавит вашей программе только плюсы. 


Для получения поддерживаемых режимов используется функция Епатртз- 
р1аузеее1паз. Она имеет три аргумента. Первый аргумент является указате- 
лем на строковое значение с именем устройства вывода. Для У! ш- 
40%5 95/98/МЕ это значение должно быть установлено в мот. Для У ш- 
4о\5 МТ/2000/ХР/$ВЗ можно указать параметр оеу1семаме структуры 
ОТЗРЬАУ РЕМТСЕ. Данная структура позволяет сохранять различные параметры 
для устройства вывода, используется в функции Епамр1 зр1аубеу1сез и будет 
рассмотрена далее в этой главе. Второй аргумент функции Епотр1 зр1ау$ее- 
61093 определяет тип возвращаемой информации и может принимать одно 
из следующих значений: ЕМОМ СОВВЕМТ_ЗЕТТТМС$ (получить текущие парамет- 
ры) ИЛИ ЕМОМ ВЕСТЗТВУ ЗЕТТТМС$ (получить параметры из реестра). Кроме 
того, этот аргумент является своеобразным счетчиком. Данная функция 
должна вызываться определенное число раз (по одному для каждого под- 
держиваемого режима), и второй аргумент увеличивает значение счетчика 
при каждом вызове функции, начиная с 0. Последний аргумент функции 
является указателем на структуру РЕУМОБЕ, в которую записывается инфор- 
мация о найденном режиме. Формат данной структуры очень велик и мно- 
гие ее поля не имеют прямого отношения к информации о режиме, поэтому 
приведу описание только нужных нам полей. 


О Поле атвлезРехРе1 предназначено для хранения информации о глубине 
цвета (в битах) для найденного режима: 4 бита для 16 цветов, 8 — для 
256 цветов, 16 — для 65 536 ит. д. 


О Поле атРетзи1аен определяет разрешение по горизонтали в пикселах. 


| 


Поле атРе1ззНеганеЕ определяет разрешение по вертикали в пикселах. 


ОС Поле атрзэр1ауЕгеачиепсу определяет частоту кадровой (вертикальной) 
развертки (частота обновления экрана) в герцах. Данное поле не поддер- 
живается в УМш4оуз 95/98/МЕ. 
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Кроме того, перед использованием структуры РЕУМОБЕ следует записать 
в ПОЛе дм51=2е размер самой структуры (512еоЕЁ(РЕУМОРЕ)), а в поле 
тра уехЕхега — значение 0. Теперь у нас есть все необходимые составляю- 
щие, чтобы написать собственную функцию для получения всех подлержи- 
ваемых устройством режимов. Пример такой функции показан в лис- 
тинге 4.45. 


Листинг 4.45. Перечисление всех поддерживаемых видеорежимов 





// определим глобальную переменную 
РЕУМОРЕ* ЧУМоае = МОБЬ; // указатель на структуру РЕУМОРЕ 
// назовем нашу функцию беф01зр1ауМодез 
%У014 Сеё015р1ауМоаез ( НИМР ЮСопроВох) 
{ 
// счетчик для функции Епот01 5рфаубеЕе119$ 
РИОВР амМопфегМоае = ( РМОВО} -1; 
// буфер форматирования и вывода информации 
ТСНАВ +52Мо4е [100]; 
// выделяем необходимое количество памяти 
ЯУМоае = пем РЕУМОРЕ [250]; // максимум 250 режимов, если найдутся 
// если нет свободной памяти, завершаем функцию 
1Е ( аУМоае == МО.) гебагп; 
// пишем цикл для поиска всех возможных режимов 
ао { 
// увеличиваем счетчик на единицу 
ЧмЯ\отретМоае ++; 
// заполняем требуемые поля структуры РЕУМОРЕ 
ЧУМоае [9мМопбетМоае].ам$12е = з1теоЕЁ ( ПЕУМОВЕ); 
@УМоае [амМапоегМоае] .аиОг1уетЕхеЕга = 0; 
} уб11е ( Ерот01зр1ау$еее1таз ( МОШЬ, ЧмМоетМоаде, 
& аУМоае [амМопьегМоае])); 
// форматируем полученные данные 
Рог (16 1 = 0; 1 < АмМомоетМоае; 1++) 
{ 
// если в поле да01зр1ауЕгедаепсу стоит 0 или 1, игнорируем его 
1Е (Ч9УМо4ае [1].4т015р]ауЕгедаепсу == 0 || 
ЯУМоае [1].д0узрЪауЕгеасерсу == 1) // И1паомз 95-98-МЕ 


эрутпЕЕЁ ( Е52Моде, _ ТЕХТ ( "ЗА х %4 (%а 61%), 0 Н2"), 
ЧУМоЧе [1].чтРетз\1акр, ЯуМоае [1].атРеЪтзНетаве, 
ЧУМоде [1].9тВ1е5РегРе1); 
} 
е1зе // М1паомз МТ-2000-ХР-2003 
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изретпЕЕ ( Е32Моае, __ТЕХТ ("39а х %а (%а 61Е), %4 Н2"), 
АУМоде [1].атРе1з\1ав, ЯУМоде [1].атРеЪтзНелтай&, 
АУМоае [1].амВ1ЕзРегРе], А\УМоае [1] .9тр15р]ауЕгедиелсу); 
} // ера 1Е 
// записываем отформатированную строку во внешний список 
Зеп9Меззаде ( ПСомфоВох, СВ АБОЗТАТМС, 0, (ТРАВАМ) (ТРСТЗТВ) +52Моае); 
} // епа Еог 
// выбираем в списке самый верхний пункт 
зепаМеззаде ( ПСопроВох, СВ ЗЕТСОВЗЕТ, 0, 0); 
// освобождаем память 
1Е ( аУМоае} ае1ефе [1] ауМоае; 
} // выходим из функции 


Как видно из этого примера, наша функция сеер:зр1аумодез имеет всего 
один аргумент — дескриптор раскрывающегося списка (сопфовох). После 
выполнения функции в списке будут размещены все найденные режимы. 
Поскольку некоторые системы (\Мтао\$ 95, 98 и МЕ) не возвращают зна- 
чение вертикальной частоты, мы использовали дополнительное условие, 
в котором проверяли значение поля ато1зр1ауЕгечиаептсу. Если оно равно 0 
или 1, значит, операционная система не поддерживает получение частоты. 
Для надежности можно проверить текущую версию \У/л9о\5 с помошью 
функции бефкУегз1от. Рекомендую всем читателям в профессиональных при- 
ложениях использовать именно такой вариант. 


Созданная нами функция прекрасно справляется с поставленной задачей, 
но имеет один неприятный сюрприз: информация о поддерживаемых режи- 
мах выводится не по порядку, а хаотично. Этот минус легко исправить, до- 
бавив код сортировки найденных режимов (например, с помощью функции 
азог"). 


После того как мы определили все режимы, можно использовать функцию 
СВапаер1 р1аубете1птаз для установки нового режима. Функция имеет всего 
два аргумента, первый из которых является указателем на структуру БЕУМОРЕ, 
а второй определяет флаг выполнения операции. Список всех флагов при- 
веден в табл. 4.47. 


Таблица 4.47. Список флагов функции срапдер1р1ау5ееЕ1птаз 


Флаг Описание 

0 Смена режима будет выполнена динамически 

С05_ТЕЗТ Пробная установка требуемого режима 

С05_ОРБАТЕВЕСТЗТВУ Смена режима будет выполнена динамически и сохранена 


в системном реестре 
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Таблица 4.47 (окончание) 


Флаг Описание 

С0$_ЗЕТ_РЕАТМАВУ Позволяет выбрать текущее устройство вывода на экран 
первичным 

Ср5_ВЕЗЕТ Смена режима будет выполнена, даже если требуемый ре- 


жим уже установлен ранее 


После выполнения функция СЬапдер:зр1аузекЕ1таз возвращает определен- 
ное значение, по которому легко узнать результат операции. При успешной 
смене режима будет возвращено значение рт$Р СНАМСЕ ЗОССЕЗ$РОЬ. Если 
функция возвратит значение рт5Р СНАМСЕ ВЕЗТАВТ, ТО необходима переза- 
грузка компьютера для активизации выбранного графического режима. 
В случае невозможности установить требуемый режим функция вернет зна- 
чение от5Р СНАМСЕ РАТЬЕР, а если указанный графический режим не подлер- 
живается, то ОТ$Р СНАМСЕ_ВАОМОРЕ. 


А теперь рассмотрим на практике установку нового графического режима 
в УМпдо\5. Для этого напишем код, показанный в листинге 4.46. 





Листинг 4.46. Установка нового графического режима 
// назовем функцию 5ес01зрЪауМодез 
11Е ЗеЕр1зр1ЪауМодез ( ОЕУМОРЕ* поде) 
( 
ОМС 1ВезафЕ = 0; 
// проверяем указатель 
1Е ( поае == МОБ) гебагп -1; 
// устанавливаем новый режим дисплея 
1Вези1& = Спапдер15рЪау$еЕ 1195 ( шоде, С0$_ОРРАТЕВЕСТУТВУ); 
// обрабатываем результат операции 
зи1ЕСВ ( 1ВезаЕ) 
{ 
сазе ОТЗР СНАМСЕ_ ЗИОССЕЗЗЕОЬ: 
// операция успешно завершена 
гебсагп 0; 
сазе Р15Р СНАМСЕ ЕАТТЕР: 
// не удалось установить требуемый режим 
гесаги 1; 
сазе ОТ5Р СНАМСЕ ВЕЗТАВТ: 
// требуется выполнить перезагрузку ПК для активации режима 
гевагп 2; 
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// неизвестная ошибка 

гебаги -1; 

} 

// теперь можно вызвать нашу функцию для установки режима 
ЗеЕ01зр1ауМодез ( &ЧуМоде [21); // выбираем из списка режим 2 


Поскольку указатель на структуру БЕУМОРЕ мы сделали глобальным, можно 
вызывать нашу функцию $е+01зр1ауМодез в любом удобном месте. В качест- 
ве аргумента ей передается указатель на рЕУМОВЕ. Номер выбранного нами 
режима (2) абсолютно случаен. Кроме того, еще раз замечу, что описания 
режимов в массиве структур РЕУМОБЕ расположены хаотично, а потому нуж- 
но быть очень внимательным при передаче номера режима, а лучше отсор- 
тировать все режимы по порядку. 


4.4.2. Проверка возможностей 
видеоадаптера 


В \Ушдо\м5 существует удобная возможность получить различную полезную 
информацию о параметрах текущего графического режима, а также совмес- 
тимости установленного видеоадаптера с различными графическими функ- 
циями рисования и управления цветом. Со всеми этими задачами справля- 
ется одна-единственная функция сесреу1сеСарз. Она имеет всего два аргу- 
мента: первый определяет контекст устройства (для получения текущих 
параметров можно установить в моы.), а второй аргумент определяет флаг 
для требуемого параметра. Список интересующих нас флагов представлен 
в табл. 4.48. Возвращаемое значение функции зависит от установленного 
флага. 


Таблица 4.48. Список флагов функции сеЕреу1сеСарз 


Флаг Описание 


ОВТУЕВУЕВЗТОМ — Позволяет получить версию драйвера устройства 


АБРЕСТХ Относительная ширина пиксела устройства для рисования линии 
АЗРЕСТУ Относительная высота пиксела устройства для рисования линии 
АЗРЕСТХУ Ширина пиксела устройства по диагонали для рисования линии 

ВТТЗРТХЕЬ Число граничных битов для отображения цвета каждого пиксела 
СЬТРСАР5 Поддержка устройством прямоугольных областей отсечения 


(1 — есть, 0 — нет) 


СОТОВВЕЗ Фактическое разрешение по цвету (бит/пиксел). Следует применять 
только, если установлен бит вс_РАЪЕТТЕ для флага ВАЗТЕВСАР$ 
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Флаг 


СОВУЕСАР$ 


НОВ2ВЕЗ 
УЕВТВЕЗ 
НОВ2512Е 
УЕВТЗТОЕ 


ГТМЕСАР$ 


ТОСРТХЕИ5Х 
ГОСРТХЕЦЗУ 
МОМВВОЗНЕ$ 
МОМРЕМ$ 
МОМРОМТ$ 
РЬАМЕЗ 


МОМСОГОВ$ 


ВАЗТЕВСАРЗ 


ЭТРЕРАТЕТТЕ 


УВЕЕВЕЗН 
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Таблица 4.48 (окончание) 


Описание 


Определяет поддержку вывода кривых линий (сс_момЕ — нет, 
СС_СТВСЬЕ$ — ОКРУЖНОСТЬ, СС_ЕЪЬТРЗЕЗ — ЭЛЛИПС, СС_ВООМОВЕСТ — 
скругленный прямоугольник, сс_ртЕ — сектор, сс_сново — хорда). 
Возвращаемое значение является комбинацией возможных 
значений 


Ширина экрана в пикселах 

Высота экрана в строках растра 

Ширина физического экрана в миллиметрах 
Высота физического экрана в миллиметрах 


Определяет поддержку вывода кривых линий (ъ<_момЕ — нет, 

ЪС МАВКЕВ — маркер, тс _РОоБУзтмЕ — ломаная линия, 15 итрЕ — 
широкая линия). Возвращаемое значение является комбинацией 
возможных значений 


Количество пикселов на одном логическом дюйме по ширине 
Количество пикселов на одном логическом дюйме по высоте 
Поддерживаемое число кистей 

Поддерживаемое число перьев 

Поддерживаемое число шрифтов 

Количество цветовых плоскостей 


Если устройство не поддерживает цвет больше 8 битов на пиксел, 
будет возвращено число входов в таблице цветов, иначе —1 


Определяет поддержку растровых операций (вс _РАБЕТТЕ — зависит 
от палитры, вс_вттвьт — растровые изображения, вс_зсаАТМе — 
масштабирование). Возвращаемое значение является 
комбинацией возможных значений 


Количество входов в системной палитры (должен быть установлен 
бит вс_РАЪЕТТЕ для флага ВАЗТЕВСАРЗ) 


Частота вертикальной развертки в герцах (в МИпдо\миз 95/98/МЕ 
не поддерживается) 


Попробуем на примере воспользоваться данной функцией. В листинге 4.47 
приводится удобный способ получения параметров текущего графического 


режима. 





Листинг 4.47. Получение параметров для текущего графического режима 





// объявляем переменные 


НОС ВОС = МОБ; 


// дескриптор контекста устройства 
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// переменные для хранения параметров режима 
ОИОВО амх = 0, аму = 0, омвл = 0, амН2 = 0; 
ОИОВОР амВазфег = 0, ЧмСо1огз = 0; 
// получаем текущий контекст устройства 
ВОС = сбеёрс ( №); 
их = бесреу1сеСарз ( ВОС, НОВРВЕ$З); // разрешение по горизонтали 
ЧмУ = СеЕреу1сеСарз ( ВОС, УЕВТВЕ$); // разрешение по вертикали 
ЧмВ16 = бебреу1сеСарз ( ВОС, ВТТУРТХЕЬ); // разрядность цвета 
ЧиН2 = Сесоеу1сеСарз ( ВРС, УВЕЕВЕЗН); // частота по вертикали 
// проверяем поддержку растра 
ЧВазсег = Сесреу1сеСарз ( ВОС, ВАЗТЕВСАРЗ$); 
// проверяем поддержку палитры 
ЧиВазтег = ( ЧмВазфег & ВС РАТЕТТЕ) ? сгае : Еа1зе; 
1Е ( ЧиВазкег) // палитра поддерживается 
// получаем число цветов 
@мСо1ог$ = СесреулсеСарз ( ЮОС, ЗТДЕРАЦБЕТТЕ); 
е1зе // палитра не поддерживается 
Чмсофогз = сСегреулсеСарз ( ВОС, ММСОГОВ$); 
// освобождаем контекст устройства 
Ве1еазебС ( мо, вос); 


4.4.3. Управление монитором 


И последнее, с чем хочется познакомить читателя, — это возможности 
управления монитором. Выбор графических режимов мы уже разобрали, а 
теперь поговорим о поддержке \Мп32 АР энергосберегающих возможностей 
монитора. Сушествует, как минимум, две операции по управлению питани- 
ем монитора: первая позволяет перевести монитор в ждущий режим, а вто- 
рая полностью выключает основные цепи питания, переводя устройство в 
режим сна. Во втором режиме потребление питания наименьшее. Сразу 
замечу, что описываемые возможности будут работать только с мониторами. 
поддерживающими энергосберегающие режимы (все современные устройства). 


Для управления режимами мы будем применять функцию Роз+Меззаде. Для 
тех, кто не знаком с ней, скажу, что данная функция позволяет поместить 
любое сообщение в общую очередь, связанную с текущим процессом и воз- 
вратить управление без ожидания результата. Для управления монитором 
мы должны будем послать ему системное сообщение им $у$СоммАКО с допол- 
нительным параметром 3с_мМОМТТОвРОМЕВ. Как это делается, можно посмот- 
реть в листинге 4.48. 





: Листинг 4.48. Управление питанием монитора 


// функция для перевода монитора в ждущий режим 
уо1Я Моп1богромРоиег () 
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РозЕМеззаде ( НИМР ВВОАРСАЗТ, ММ ЗУЗСОММАМР, $С_МОМТТОВРОМЕВ, 1); 
} 
// функция для выключения монитора 
%\019 Моп1ЕогОЕЕРомег () 
{ 
Роз{Меззадче ( НИМОР ВКОАРСАЗТ, ММ $УЗСОММАМО, $С МОМТТОВРОМЕВ, 21); 


Как видите, все достаточно просто и эффективно. Первый аргумент функ- 
ЦИИ НИМ ВВОАБСАЗТ указывает на то, что сообщение должно быть послано 
всем окнам верхнего уровня (в том числе скрытым и зависшим) в системе. 
Второй аргумент определяет сообщение им зузсоммамо. Третий и четвертый 
аргументы описывают дополнительные параметры управления. В данном 
случае это специальное значение для управления питанием монитора и код 
операции (1 или 2). 


На этом, думаю, можно закончить рассмотрение вопросов программирова- 
ния видеоконтроллера и монитора. 


ГЛАВА 5 


Работа с видео 


Пожалуй, возможность просмотра видеофильмов является второй после иг- 
рушек причиной покупки современного домашнего компьютера. И это не 
удивительно. С покупкой мультимедийного компьютера на второй план 
уходит видеомагнитофон с его громоздкими кассетами и посредственным 
качеством изображения и звука. 


Для реализации поддержки видео в операционных системах \!пдо\з фирма 
М!сгозой разработала собственный формат, ставший стандартом де-факто. 
Называется он АУГ (Аиаю-Уео Ниецеауе4 — формат с чередованием 
аудио- и видеоданных). Данный формат поддерживает видеоизображение и 
звук, синхронизированные между собой. Файл в формате АУГ имеет расши- 
рение с таким же названием (ау!) и содержит последовательность растровых 
изображений, а также один или более каналов звука. Формат АУ! может 
использовать различные методы сжатия повторяющихся данных, что позво- 
ляет немного уменьшить конечный размер файла, но, тем не менее, обеспе- 
чивает отличное качество изображения и звука. Однако, несмотря на это, 
использование данного формата ограничено в основном предварительной 
обработкой (например, оцифровкой данных с видеокамеры с последующим 
редактированием) исходных видеоданных. Связано это с тем, что, даже не- 
смотря на сжатие данных, выходной файл может иметь огромные размеры 
(в зависимости от разрешения и глубины цвета). Для записи же видеодан- 
ных на диски используются, как правило, другие форматы, обеспечивающие 
более высокую степень компрессии (например, МРЕС 2, 4). 


В любом случае, если вы работаете в \/п9о\з, так или иначе придется 
столкнуться с форматом АУТ (оцифровка аналоговых данных, организация 
интерактивного интерфейса и т. д.). Поскольку этот формат является стан- 
дартным для У/Ишао\, фирма М!сгозой позаботилась о его программной 
поддержке, добавив соответствующие возможности в \т32 АР]. 
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В этой главе мы попытаемся научиться работать с АУ1-файлами посредст- 
вом указанного выше интерфейса. Для этого мы воспользуемся двумя раз- 
личными, как по сложности, так и по возможностям, способами: 


1. Использование универсального интерфейса управления мультимедийны- 
ми данными (МСЕ — Мефа Сопио! Пиенасе). 


2. Использование набора функций поддержки видео в У/таом$ (УЕ\У — 
Учео Юг УЛп4о\$). 


5.1. Использование МС] 


Первый способ наиболее простой и позволяет быстро добавить в программу 
поддержку файлов в формате АУТ, но имеет ограниченные возможности. Он 
идеально подходит для создания интерактивного интерфейса, а также раз- 
личных анимационных эффектов. Кроме видеофайлов, он поддерживает 
аудиодиски (СОРА), файлы \/АУ и МПГ. Здесь мы рассмотрим только ту 
часть, которая относится к работе с видео, а в гл. 7 познакомимся с про- 
граммированием звука. 


Для активизации интерфейса МСТ необходимо добавить в проект заголо- 
вочные файлы ММзумет.Н и УМ, а также библиотеки УМпит.ЛЬ и 
УЁу.15. Это необходимо для правильной инициализации функций, структур 
и констант, поддерживающих мультимедийные возможности У/л40\5. 


Чтобы воспроизвести А\У!-файл, можно воспользоваться слелующими мак- 
рокомандами: 


О мсгиоасгеаее. Является функцией. Позволяет открыть устройство МС! 
или АУ[-файл и зарегистрировать собственное окно для просмотра ви- 
деоданных; 


П мстипартау. Начинает воспроизведение текущего файла; 


С мстипаноме. Позволяет установить исходное состояние воспроизведения 
(устанавливает курсор чтения в начало файла); 


С мстипаРаизе. Приостанавливает текущее воспроизведение; 


О мстгупавезице. Продолжает воспроизведение, остановленное командой 
МСТипаРацзе;, 


Г] мсгипа$ъор. Останавливает текущее воспроизведение; 





О мстчрарезегоу. Необходимо вызвать эту команду для закрытия устройства 
МСЕГ и закрытия окна просмотра; 





ОС мсгчоастозе. Данная макроксманла также закрывает устройство МСТ, но 
оставляет окно просмотра активным. В дальнейшем его можно использо- 
вать для повторного просмотра АУ\У[-файла. 
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Существует еще ряд дополнительных макрокоманд, но в данном случае они 
нам не понадобятся. Прежде чем перейти к практике, разберем подробнее 
основную функцию поддержки видеоданных. 


Функция мстипаСгеа«е содержит четыре аргумента, каждый из которых име- 
ет определяющее значение: первый аргумент вупаРахепе указывает на деск- 
риптор родительского окна (нимо). Второй аргумент ьтпэеапсе содержит де- 
скриптор текущего приложения (нтм5тАМСЕ). Третий аргумент ам5+у1е опре- 
деляет комбинацию стандартных стилей для окна: 


О и5 узсвотл, — добавить вертикальную линейку прокрутки; 

О из нусвотл, — добавить горизонтальную линейку прокрутки; 
О из отЗАВЬЕР — отключить сообщения от мыши и клавиатуры; 
О и5 ЕХ СОМТЕХТНЕГР — добавить контекстную справку; 

О и5 Ех мотснтьо — создать дочернее окно; 





О И5 ЕХ ТОРМОЗТ — расположить поверх всех видимых окон. 


Дополнительно к ним можно указать специфические стили, используемые 
только в этой функции: 


С мстимоЕ МОАОТОЗТ2ЕИТМРОЙ — не изменять размеры окна при изменении 
размеров отображаемых видеоданных; 

0 мстимог мокВВОВОТс — отключить сообщения об ошибках МСТ; 

0 мСтимог МООРЕМ — блокировать команды меню для открытия файла; 

0 мстимоЕ морьАУВАВ — скрывать панель инструментов; 

0 МСтимог моттЕУРО$ — уведомлять о текущей позиции воспроизведения; 

О МСТимоЕ МОТТЕХАТТ, — использовать все доступные уведомления; 








0 МСтиМог 5НОИРО$ — отображать текущую позицию в области заголовка. 


Последний четвертый аргумент функции $52Е11е содержит указатель на тек- 
стовую строку с нулевым символом на конце (трэтв), которая хранит имя 
устройства МС! или А\У!-файла. В случае успешного завершения функция 
МСТИпЯСтеаке возвращает дескриптор окна (нимр) для вывода видеоданных. 
Полученный дескриптор окна понадобится нам в качестве основного аргу- 
мента для используемых в дальнейшем макрокоманд. 


Рассмотрим пример программы, которая позволяет воспроизводить видео- 
файлы в формате АУТ или МРО в главном окне. Основной код программы 
представлен в листинге 5.1. 





// подключаем основные системные файлы 


Ностаде <и1паомз.Н> 
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Н1остаЧе <УЁЕм. [> 

#1ос1таае "гезочгсе.В" 

// глобальные переменные 

НТМ$ТАМСЕ ВТпзе = МОБЬ; // дескриптор программы 

НИМО БупдАУТ = МОБ; // дескриптор окна вывода данных 

ВООТ РРаазе = ЕАШЗЕ; // состояние воспроизведения 

ВООТ ЮОреп = КАТЗЕ; // состояние наличия открытого файла 

ТРСТЗТВ 1рз2Т141е = "АУТ Р1ауег"; // заголовок окна 

ТРСТУТВ 1рз2АррМаше = "Му АУТ Р1ауег"; // уникальное имя программы 

// главная оконная функция 

ТВЕЗОТТ САГТВАСК У1пдомАУТРгос ( НИМР Б\па, ОТМТ оМза, ИРАВАМ иРагатм, 

ТРАВАМ 1Рагап); 

// функция для открытия нового видеофайла 

у01а ОрепАУТМоузе ( НИМР ВБ\па); 

// главная функция программы 

10Е АРТЕМТВУ И1пМа1п ( НТМЗТАМСЕ ВТпзкапсе, НТМУТАМСЕ пРгеуТпзфапсе, 
.РТУТВ 1рСпаГ1пе, 1пе пСиа5вом) 





М5С 54а; 
НИМО Вира; 
УМОСТАЗЗЕХ ис; 
// определяем параметры окна программы 


ус.збу1е = С5 НВЕШВАИ | С$ УВЕШВАИ; 

ус. ]рЕпИпарРгос = ( УМОРВОС) ИзпаомАУТРгос; 

ус .сЬС15Ехега = 0; 

ус. сЬипаЕхега = 0; 

ус .БТпзсапсе = БГозбапсе; 

`мс.ВТсоп = м; 

ис.ПСигзог = ТоаЧСагзог ( МОТ, ТОС АВВОЙ); 


ус .ВргВаскагочпа 


( НВВО$Н) ( СОТОК ИТМРОЙ +1); 
// имя нашего меню из файла ресурсов 


ус.1рз2МепоМаме = "АУТРЦАУЕВ"; 
ус.1р52С1аз5Мате = 1р$з2АррМаще; 

ус. сЬобтге = 312еоЕ ( ИМОСЬА$5ЕХ); 
ус .ВТсопбм = мМОШ; 


// и регистрируем собственный класс окна в системе 
3Е ( 'Вед1зегС1аззЕх ( 5мс)) 

гебагп ( РАТЗЕ); 
ВТп5е = ЮТазфапсе; 
// создаем внешний вид окна 
ВИП = Сгеабем1паом ( 1рз2АррМаще, 1рз2Т1Е1е, И$ ОУЕВЦАРРЕРИТМРОЙ, 

300, 0, 200, 0, МОМ, МОТ, БТозбапсе, МО); 

// если не удалось создать окно, завершаем программу 
ЗЕ ( !6Мла) 

гегиагп ( РАТЗЕ); 
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// отображаем окно на экране 
ЗВоми1пао\ч ( ВИпа, пСтазЗВом); 
Ордафей1паом ( Ва); 
// открываем и инициализируем устройство МСТ 
ВупЧАУТ = МСТМпаСгеаее ( БИпа, БТлзфапсе, И$_СНТЬО | и5 УТЭТВЬЕ | 
МСТИМОЕ МООРЕМ | МСТИМРЕ МОРТАУВАВ | МСТУМРЕ МОТТЕУЗТЬЕ | 
МСТИМОЕГ МОЕВВОВОЬС, МОШ)); 
// если открыть МСТ не удалось, завершаем программу 
1Е ( !ПипаАУТГ) 
{ 
Рез&гоуй1п4ом ( ВИпа); 
гебагп ( ЕАГЗЕ); 
} 
// запускаем цикл обработки сообщений 
у211е ( СбеЕМеззаде ( &аза, МИШ, 0, 0)) 
{ 
Тгапз1акеМеззаде ( &159); 
О15раесЬМеззаде ( 5154); 
} 
тебогп ( пз9.мРагам) ; 
} 
// главная оконная функция нашей программы 
ТВЕЗОГТ САГТВАСК И1пЧомАУТРгос ( НУМО БИра, ОТМТ оМза, ИРАВАМ иРагамщ, 
ТРАКАМ 1Рагам) 
{ 
Зи1ЕСВ ( 9Мза) 
{ 
// обрабатываем команды меню 
сазе ММ СОММАМО: 
зм1Еср ( ТОМОВО ( мчРагам) } 
{ 
// открываем файл 
сазе ТОМ _ОРЕМ: 
ОрепАУТМох1е ( ЮИпа); 
ргеак; 
// начинаем воспроизведение 
сазе ТОМ РТАУ: 
1Е ( ВитаАУТ && БОреп) 
МСТ\ИпарР1ау ( БмпдАУТ); 
Ьгеак; 
// обработка паузы 
сазе ТОМ РАОЗЕ: 
БРаазе = !БРацзе; 
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// приостанавливаем воспроизведение 
1Е ( БРацзе) 
МСТИпаРаизе ( ВиутдАУТ); 
е1з5е // продолжаем воспроизведение 
МСТИпаВезите ( БиупдАУТ); 
Бгеак; 
// останавливаем воспроизведение текущего файла 
сазе ТОМ $ТОР: 
МСТИва$®ор ( БупаАУТ); 
Ьгеак; 
// переводим позицию воспроизведения в начало файла 
сазе ТОМ ВЕЗЕТ: 
МСТИпаНоме ( БупдАУТ); 
ргеак; 
// закрываем текущий видеофайл 
сазе ТОМ СТОЗЕ: 
БОреп = РАГ5Е; 
ЬРаизе = ГАЦЗЕ; 
МСТИПЯС1о$зе ( НупдАУТ); 
Ьгеак; 
// завершаем работу с программой 
сазе ТОМ ЕХТТ: 
// закрываем текущий видеофайл 
МСТИпаС1озе ( ВБмпдАУТ); 
// закрываем устройство МСТ 
МСТИпарезегоу ( БипаАУТ); 
// закрываем окно программы 
РезЕкоуйзпаом ( НИпа); 
ргеак; 
} 
Ьгеак; 
// завершаем работу с программой 
сазе ММ РЕЗТВОУ : 
Роз Ои1Меззаде (0); 
ьгеаКк; 
ЧеЁай1*: 
гебаги ( РеЕ\М1пЧомРгос ( ПМпа, оМза, мчРагам, 1Рагам)); 
} 
гебагп ( 01); 
} 
// функция для открытия нового видеофайла 
уо14 ОрепАУТМоузе ( НИМР ВБИпа) 
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// объявляем переменные 

ОРЕМЕТТЕМАМЕ оЁп; 

эсак1с сваг 52Е11е [МАХ РАТН]; 

зсаё1с сБаг з2Е11етТ11е [МАХ РАТН]; 

// обнуляем структуру ОРЕМЕТТЕМАМЕ 

пемзее ( &оЁп, 0, з12еоЁ ( ОРЕМЕТЬЕМАМЕ)); 

// инициализируем структуру ОРЕМЕТТЕМАМЕ 
оЁп.15%хасЕб4хе = з1хеоЕ ( ОРЕМЕТЬЕМАМЕ); 
оЁп.ВиупАО%тег = В\па; 
оп. 1р$екЕЕ11%ег = "АУТ Е11е$\0*.ау1\0МРС Е11ез\0*.пра\0 

А11 Е11е5\0*.*\0\0"; 
оЁп.1рзетР11е = з2Е11е; 
оЁп.пМахЕ11е = з12хеоЕ ( з2Е11е); 
Оп. 1рзЕгР11еТаЕ1е = з2Е11еТ1Е1е; 
оЁп.пМахР11еТ1е]е = з12еоЕЁ ( 3з2Е11еТ1е1е); 
оЁп.Е1адз = ОЕМ_ РАТНМОЗТЕХТЗТ | ОЕМ_ЕТЬЕМОЗТЕХТТ; 
// открываем файл 
1Е ( СееОрепЕ11еМаме ( воЕп)) 
{ 
// если открыт предыдущий файл, закрываем его 
1Е ( БОреп) 
МСТИПаС1о5$е ( БипадАУТ); 
БОреп = ТВОЕ; 
1 ( МСТМо9Ореп ( БипдАУТ, оЕп.1рзЕтРа41е, 0) == 0) 
{ 
ЗВомИ1паом ( ВипдАУТ, ЗИ $НОМ); 
} 
е1зе // не удалось открыть выбранный файл 
( 
БОреп = ГАЦ5Е; 
// выводим сообщение об ошибке 
МеззадеВох ( ВИпа, "Не удалось открыть выбранный файл", МО, 
МВ_ТСОМЕХСТАМАТТОМ | МВ _ОК}); 


} 
// обновляем окно просмотра 
Тпуа]1Чафекес® ( Бра, мо, ЕАТЗЕ); 
Орааеейзтаом ( ВИпа); 
} 


Кроме основного файла, необходимо создать в редакторе ресурсов собст- 
венное меню. При этом в ваш проект будет автоматически добавлен файл 
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гезоигсе.П с описанием идентификаторов меню. Примеры файла и описате- 
ля ресурсов приведены в листинге 5.2 и 5.3 соответственно. 


//МзсгозоЕЕ Беуе1орег З®аЧ1о депегаееЯ гезоигсе зсг1р®. 
#1остаде "гезосгсе. в" 

#АеЁ1пе АРЗТОРТО ВЕАРОМГУ_5УМВОТ5 

$1ос1оае "аЁхгез.В" 

фопаег АРЗТОРТО ВЕАРОМЬУ ЗУМВОГ.5 

// Виззлап гезоигсез 

НЕ |! ЧеЁ1теа (АЕХ_ВЕЗОЧВСЕ _РЫ,) || аеёзпеа (АЕХ_ТАВС_ВИ$) 
41Е4еЕ и1м32 

ТАМСОАСЕ ЪАМС ВОЗЗТАМ, ЗОВЬАМС РЕРАОШТ 

фргадта со4е раде(1251) 

#епатЕ // и1м32 


// Мепа 
АУТРЬАУЕВ МЕМО ОТЗСАВРАВГЕ 
ВЕСТМ 
РОРИР "&Р11е" 
ВЕСТ 
МЕМОТТЕМ "Ореп Е11е...", ТОМ ОРЕМ 
МЕМОТТЕМ "С1озе АУТ Е11е", ТОМ _СТО5Е 
МЕМОТТЕМ ЗЕРАВАТОК 
МЕМОТТЕМ "Еёх1 к", 40006 
ЕМО 
РОРОР "&\У1аео" 
ВЕСТМ 
МЕМОТТЕМ "Рау", 40003 
МЕМОТТЕМ "Раозе", 40004 
МЕМОТТЕМ "5®ор", 40005 
МЕМОТТЕМ ЗЕРАВАТОК 
МЕМОТТЕМ "Везе*", ТОМ ВЕЗЕТ 
ЕМЬР 
ЕМО 
фепа1Е // Визз1ап гезоигсез 


Листинг 5.3. Файл описателя ресурсов гезоигсе.Н 








//{ {№0 _РЕРЕМРЕМСТЕ$ } } 
// М1сгозоЕЕ Беуе1орег ЗЕаЧ1о депегаееа 1пс1о4е Е11е. 
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// 9зеа ру Стозеита. гс 














// 

}Чеё1пе ТОМ ОРЕМ 40001 
#+ЧеЕ1пе ‘ТОМ СТОЗЕ 40002 
#+9еЕ1пе ТОМ РЬАУ 40003 
#Чеё1пе ТОМ РАОЗЕ 40004 
+ЧеЕ1пе ТОМ _5ТОР 40005 
#ЧеЕ1пе ТОМ ЕХТТ 40006 
#+ЧеЕ1пе ТОМ ВЕЗЕТ 40007 
// 

// №хЕ ЧеЕао1Е уа1аез Еог печ об]есез 

// 

{+1Е4её АРЗТИОТО_ТМУОКЕР 

+1ЕлаеЕ АРЗТОРТО ВЕАРОМЬУ_ 5УМВОГ$ 

{ЧеЁ1пе _АРЗ_МО МЕС 1 
+4еЁ1пе _АР$ МЕХТ_ВЕЗОЧВСЕ УАГОЕ 101 
+4еЁ1пе _АР$ МЕХТ_СОММАМР УАШОЕ 40008 
#4еР1пе _АР$ МЕХТ СОМТВОЬ УАШЕ 1000 
#$4еЁЕ1пе _АР$ МЕХТ ЗУМЕО УАТОЕ 101 
фепа1Е 

фепа1Е 


Не забудьте в опциях компоновщика (Ргоесё| $ете$ | ТлиК) добавить 
ссылку на библиотеку УЁм.ПЬ. После этого скомпилируйте файл и запустите. 
Если все было сделано правильно, в главном окне программы появится ме- 
ню, состоящее из двух пунктов: ЕШе и Ущео. Первое меню управляет откры- 
тием и закрытием видеофайла, а также завершением работы. Оно состоит 
из следующих пунктов: Ореп Ее, С1юзе АУТ ЕЙе и Ехи. Второе меню содер- 
жит основные команды управления открытым файлом: Рау, Рацзе, ЭЗюр и 
Кезе!. Кроме стандартных файлов АУТ, вы сможете открывать и просматри- 
вать некоторые файлы в формате МРО. 


Итак, у нас получилась простая программа для просмотра видеофайлов. 
Однако у нее имеется один недостаток: размеры главного окна программы 
автоматически не подгоняются под размер видеоизображения. Это неудоб- 
ство очень легко исправить. Для этого необходимо добавить в программу 
обработку сообщений интерфейса МСТ. Для корректировки размеров окна 
применяется сообщение мстимом моттЕУЗТ2Е. Оно служит для уведомления 
родительского окна об изменении размеров окна вывода изображения. До- 
полнительно следует обработать стандартное сообщение \шво\$, инфор- 
мирующее об изменении размеров окна им зт2Е. Добавьте в основной файл 
программы (после обработки сообщения им рРЕЗТВОУ) обработку указанных 
сообщений, как показано в листинге 5.4. 
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// отрывок из функции И1пЧомАУТРЕОС 
// завершаем работу с программой 
сазе ИМ РЕЗТВОУ: 
Роз&Оо1Меззаде (0); 
Ьгеак; 
// добавляем обработку размеров окна вывода 
сазе ММ 5126: 
// если окно существует и не свернуто 
1Е ( БураАУТ && БОреп && !ТэзТсопас ( ВИпа)) 
// изменяем его размеры 
Моте\1п4ом ( Биуп9АУТ, 0, 0, ГОМОВО ( 1Ракам), 
НТМОКО ( 1Рагат}, ТВОЕ); 
ргеак; 
// обрабатываем сообщение МСТИМОМ МОТТЕУ$ТЬЕ 
сазе МСТЯМОМ МОТТЕУЗТЕЕ: 
// если окно не свернуто 
1Е ( !Т3Тсор1с ( В\Мп9)) 
{ 
// если файл открыт 
1Е ( Бореп) 
{ 
ВЕСТ гс; 
// устанавливаем размеры окна вывода 
СсеЕИ1паомВесЕ ( БипаАУТ, &гс); 
А) оз! паомВесе ( &гс, бееи1паомЬопа ( БИпа, 
СИ ЗТУБЕ), ТВОЕ); 
Зееи1паомРоз ( П\па, МОЫ., 0, 0, гс.х19ВЕ - гс.1еЕе, 
гс.Бобеом - гс.Кор, 5МР_МОФОВРЕВ | 
ЗИР МОАСТТУАТЕ | ЗИР_МОМОУЕ) ; 
} 
е15е 
{ 
// восстанавливаем размеры окна по умолчанию 
Зее\1паомРоз ( Б\па, мошь, 0, 0, 300, 200, 
ЗИР МОФОВРЕВ | 5ИР МОАСТТУАТЕ | ЗИР_МОМОУЕ) ; 


ргеак; 
ЧеЁао1& 
гебогр ( РеЁ\М1п9омчРгос ( ВИпа, чМза, мРагам, 1Рагам)); 
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Теперь наша программа стала более похожа на стандартный проигрыватель 
видеофайлов. Давайте добавим еще возможность изменения масштаба окна 
видеоданных. Для этого используются две макрокоманды: мстипабее2оот и 
МСТипазее2оот. Первая получает текущее значение, а вторая позволяет уста- 
новить новый масштаб. Поддерживаются три стандартных значения мас- 
штабирования: 50, 100 и 200 %. При установке значения 50 % размер окна 
будет уменьшен в 2 раза, а значение 200 % позволит увеличить нормальное 
изображение в 2 раза. Установка масштаба в 100 % возвращает нормальный 
размер картинки. Макрокоманда мстиразек7оот имеет два аргумента: первый 
определяет дескриптор окна вывода, а второй указывает значение желаемого 
масштаба. Добавьте в программу код, позволяющий увеличить изображение 
вдвое (листинг 5.5). Поместите его в функцию главного окна и1паомАУТРгос. 





// увеличиваем изображение в два раза 
сазе ТОМ 200МХ2: 
{ 
(МТ оСбоггепЕРоом = 0; 
// получаем текущее значение 
цСиггепе2оом = МСТИпасее?оом ( БмпдАУТ); 
// проверяем, имеет ли окно нормальный размер 
1Е ( оСигхепЕРоом == 100) 
МсТипазее2оот ( ПмпдАУТ, 200); // двойной экран 
} 


ргеак; 


А теперь рассмотрим второй способ воспроизведения файлов в формате 
АУГ. 


5.2. Использование УЕ\/ 


Данный метод имеет больше возможностей по сравнению с первым. Он по- 
зволяет не только воспроизводить А\]-файлы, но и получить к ним неогра- 
ниченный доступ: расширенная информация о файле, работа с отдельными 
кадрами изображения, а также поддержка любых совместимых с \Уп4д0%5$ 
кодеков (компрессоров и декомпрессоров). Использование набора функций 
УР\ позволяет не только создать полноценный видеоплеер, но и профес- 
сиональный редактор для обработки файлов в формате АУТ. 


Для организации воспроизведения видеофайла необходимы следующие ба- 
зовые функции и макрокоманлы: 


О лутЕлегла*. Предназначена для загрузки и инициализации набора функ- 
ций УР\; 


[№ 


[№ 


214 Часть |. Работа с аппаратными ресурсами в ИИпаоиз 


АУТЕ11еЕх1*. Освобождает ресурсы системы, задействованные для УЕ\. 
Данную функцию необходимо вызвать перед завершением программы. 
На каждый вызов функции АУТЕ11ети:е должна быть вызвана функция 
АУТЕ11еЕх1; 


АУТЗЕгеапОрерЕготЕ11е. Позволяет открыть новый поток для указанного 
файла АУГ; 


АУТ геацве1еазе. Закрывает указанный поток для АУ[-файла и освобож- 
дает используемые ресурсы; 


АУТ5ЕгеашСе® Егащеореп. Извлекает первый кадр из потока и подготавлива- 
ет (проводит декомпрессию) его к выводу на экран; 


АУТЗЕгеаптепаеВ. Возвращает длину для указанного потока в выборках 
(сэмплах); 


АУТ геапЕраТ1ме. Позволяет получить конечное время для указанного 
потока; 


АУТ геашТпЕо. Читает информацию об указанном потоке. Каждый поток 
имеет область заголовка, в котором содержится различная информация: 
тип потока, размер кадра, размер одной выборки, длина потока и др.; 


АУТ геамсекЕгаше. Возвращает адрес восстановленного (декомпрессиро- 
ванного) кадра. Кадр имеет формат упакованного ОВ-изображения; 


Рхамр4Ьргам. Выводит растровое изображение на экран; 


АУТ геапвеаа. Позволяет прочитать видео, аудио и другие данные из ука- 
занного потока; 


Рхамр1Бореп. Загружает и инициализирует библиотеку для поддержки рас- 
тровых изображений (ОВ); 


Рхаи01ЪС1озе. Освобождает ресурсы, занятые библиотекой обработки рас- 
тровых изображений (0[В); 


АУТ геамбе*ЕгамеС1озе. Освобождает ресурсы, выделенные для деком- 
прессии и подготовки кадров к выводу на экран. 


А теперь на основе этих функций напишем собственный класс для про- 
смотра видеоданных в формате А\У1. Для удобства работы мы будем исполь- 
зовать средства библиотеки МЕС. Это существенно упростит задачу и 
уменьшит размер конечного кода. Назовем наш класс сАУТ и создадим его 
определение так, как показано в листинге 5.6. 


Листинг 5.6. Файл АМ.П класс сАУТ 


// Файл АУТ.В: 1п%егЕасе Фог Пе САУТ с1азз. 


// 


подключим файл объявлений для библиотеки УЕМ 


#1осфаае "уБи.Б" 
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// сообщение для таймера 
#аеЕ1пе ТТМЕК_ ОРРАТЕ ИМ ОЗЕВ + 2000 
// класс САУТ 
с1азз САУТ : рию11с Сила 
{ 
риБ11с: 
// конструктор и деструктор по умолчанию 
САУТ (); 
У1гЁиа1 -САУТ (); 
// общедоступные функции класса САУТ 
// функция для загрузки А\УТ-файла 
112 Тоаа ( ОРСТЗТВ 1р$з2АУТЕ11е); 
// функция для установки цвета фона АУТ-файла 
уо1А ЗеЕСо1охМазк { СОТОВВЕЕ со1ог); 
// функции управления воспроизведением 
ВООГ Р1ау (); 
ВООГ 5%ор (); 
// защищенная область класса 
ркотесфеа: 
// функции для обработки сообщений класса 
// | { АЕХ М9б { САУР 
аЁх_п59 уо1А Опрезегоу (); 
аёх пза уо1а ОпРа1п® (); 
// } } АЕХ_ М5 
РЕСТАВЕ МЕЗЗАСЕ МАР () 
// закрытая область класса 
реттаее: 
// функция для инициализации УЕ 
Уо1Я Тп11а112еАУТ (); 
// функция для освобождения ресурсов УЕМ 
уо1А ЕгееАУТ ({); 
// функция вывода очередного кадра на экран 
уо1а ЗпомЕгате ( СО0С* рБс); 
// функция для загрузки маски кадра 
уо1а Зе Егеебсгееп ( СОС* рллОС, с0С* роаЕОС, 116 х, 106 у, 
176 1сх, 116 1су); 
// функция обратного вызова для обработки событий таймера 
з$аё1с уо1а САБШВАСК ОрдафеР1ау { НММО Б\па, отмт оМзд, 
ОТМТ оЕуеле, ОМОВО ЧмТ1ме); 
// переменные для хранения растровых изображений 
СВ тар шп ВМРВСВ; 
СВ1бтар* м ВМРТЕМР; 
// переменная для хранения главного контекста вывода 
СОС м 0С; 
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// переменная для хранения цвета маски 
СОШОВВЕЕ м Со1отМазк; 
// переменная для хранения растрового изображения 
НОВАМОТВ тм ОТВ; 
// переменные для хранения размеров изображения 
116 м 1Не1ове; 
зп м паев; 
11 м У; 
106 м 1х; 
// переменная для хранения времени таймера 
ОТМТ м от1мег; 
// переменная для хранения полного числа фреймов в АУТ-файле 
ГОМС ш СочпЕЕгаще; 
// переменная для хранения текущего фрейма в А\МТ-файле 
ОТМТ м оСогЕгаме; 
// переменная для хранения текущего состояния воспроизведения 
ВООГ м ЮР1Тау; 
// указатель на открытый поток видео в А\УТ-файле 
РАУТЗТВЕАМ м р5егеащ; 
// переменная для хранения указателя на фрейм потока видео 
РСЕТЕКАМЕ м рЕгапе; 
// информационная структура для видеопотока 
АУТЗТВЕАМТМЕО АУГ1пЕо; 
}; 


Телерь напишем файл реализации класса саут так, как показано в листин- 
ге 5.7. 





Листинг 5.7. Файл АМ.срр класс сАУТ 


// Файл АУГ.срр: пирфещепеае1отп оЁ Пе САУТ с1азз$. 
#11с1аае "зе адаЁх.В" 

#1пс1оае "У1Аео. В" 

{1пс1аае "АУТ.В" 


// конструктор класса 

САУТ: :САУТ () 

{ 
// инициализируем переменные класса 
Т111а11=еАУТ (); 
// инициализируем УЕМ 
АУТЕ11еТи1® (); 
// инициализируем библиотеку поддержки РТВ 
м ОВ = РгамО1ЮОреп ({); 
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// деструктор класса 

САУТ :: -САУТ () 

{ 
// освобождаем библиотеку РТВ 
1Ё (и ОТВ) Ргамо1ЮС1озе ( м ОТВ); 
// освобождаем ресурсы УЕМ 
ЕгееАУт (); 
// выгружаем библиотеку УЕМ 
АУТЕ11еЕх1® ({); 

} 

// карта сообщений класса САУТ 

ВЕСТМ МЕЗБАСЕ МАР { САУТ, Сипа) 
ОМ ИМ РЕЗТВОУ () 
ОМ ИМ РАТАТ () 

ЕМР МЕЗЗАСЕ МАР () 

// функция инициализации 

уо1А САУТ :: Т1п161а117еАУТ () 

{ 


п р5Егеам = МОШ»; 
п рЕгаме = мМОШ; 
п ЬР1ау = РАЬЗЕ; 
п ВМРТЕМР = М0; 
п иСогЕгане = 0; 
м 1х =0; 
м 1 = 0; 


} 
// функция освобождения ресурсов 
уо1А САУТ :: ЕгееАУТ () 
{ 
// если идет процесс воспроизведения, останавливаем его 
1Е (м БР1ау) 5®ор (); 
// освобождаем ресурсы поддержки кадров 
1Е (м рЕгаме) 
{ 
АУТ5геатсекЕтатеС1озе ( м рЕгаме); 
п рЕгаше = МОГГ; 
} 
// освобождаем ресурсы видеопотока 
1# ( м р5егеат) АУТ5геашВе1еазе ( м р5егеам); 
// удаляем объект изображения 
1Е ( м ВМРВСВ.м ВОБ]ес®) м ВМРВСВ.Ре1екеОБесе (); 
// освобождаем главный контекст вывода 
1Е (м РС.м ВОС) ю_ОС.Бе1еберс (); 
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// функция вывода очередного кадра на экран 
Уо1А САУТ :: ЗБомЕкаше ( СОС* рос) 
{ 

ТРВТТМАРТМЕОНЕАРЕВ 1рВ1$тар; 

СВ1етар ВМР, *бепрВМР; 


ВЕСТ гесЕ; 
Е Н=О0, М=0; 
СОС ас; 





// получаем размеры клиентской области окна 
СеЕСс11елЕВес® ( &гесё); 
// вычисляем высоту и ширину клиентской области окна 
Н = гес®.Бобфом - гес®.Кор; 
М = гесе.к1аре - кесф.1еЕ%; 
// получаем из видеопотока очередной фрейм 
1рВ16тар = (ПРВТТМАРТМЕОНЕАРЕВ) АУТ5сгеатсееЕгаме ( м рЕгапе, 
(ТОМС) м чСигЕгапе); 
// создаем на его основе совместимый контекст изображения 
1Е ( 1рВ1 мар) 
{ 
Яс.Сгеа®еСопра*151ерС ( рос); 
ВМР.СгеакеСопра*1Ъ1еВ1тар ( рОС, М, Н); 
СетрВМР = ас.бе1есеОБЗесе ( &ВМР); 
// копируем полученное изображение в основной контекст 
ас.В1ЕВ1е (0, 0, И, Н, бм ОС, 0, 0, ЗВССОРУ); 
// выводим изображение на зкран 
Ркгам01ЬОгам ( м ОТВ, ас.СесбаЕенас (), гесф.1еЕЕ + ш 1х, 
хесё.Еор + м 1У, м 1И1АЕВ, ш 1Не19Ве, 1рВ1 тар, 
МО, 0, 0, -1, -1, 0); 
// обрабатываем маску 
зесРГгеебсгееп { &Ас, РОС, кесф.1еЕе, гесё.ФКор, ИМ, Н); 
// выбираем объект 
9с.зе1есеОЮЗесЕ ( КепрВМР); 





} 

// функция обработки маски кадра 

уо1Я САУТ :: ЗесЕгее$сгееп ( СОС* рТпОС, СОС* рооеОС, 116 х, 10 у, 
1106 1сх, тп 1су) 


СВ1етар ВМР, *СепрВМР; 

СВ©тар соруВМР, *КепрСорувВМР; 

СОС ас, сорубС; 

// создаем совместимые контексты для изображений 
Яс.Сгеа еСотраЕ1Ю1ерС ( р1п0С); 

ВМР.Сгеа®еВ1 тар ( 1сх, 1су, 1, 1, №); 
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фептрВМР = ас.бе1есеОЮ]есе ( &ВМР); 
СорУуБС .Сгеа еСотра®101ерС ( рочерсС); 
сорУВМР.СгеафеСотра{101еВ1Етщар ( рочЕОС, 1сх, 1су); 
СепрСоруВМР = сорурС.$е1есеОЮ]есе ( &соруВМР); 
// копируем данные из одного контекста в другой 
сорурС.ВзЕВ1е (0, 0, 1сх, 1су, &а БС, 0, 0, ЭВССОРУ); 
// устанавливаем фон изображения 
РТаоС->5еВКСо1ог ( м _Со1охМазК); 
4<.В1В1е (м 1%, м 1, м ПТась, м 1Не19ье, ртпос, м 1х, м ЗУ, 
`_  ЗВССОРУ) ; 
// устанавливаем цвет фона и текста для исходного контекста 
ргарс->5еВКСо1ог ( ВСВ (0, 0, 0)); 
рТпрс->5е ТехеСо1ох { ВСВ ( 255, 255, 255)); 
рТарс->81В16 (/м_1Х, м 1У, 1сх, 1су, вас, м 1х, м 1, ЗВСАМЬ); 
// устанавливаем цвет для контекста маски 
СорУрОС . бе ВКСо1ог ( ВСВ ( 255, 255, 255)); 
сорУрС. Зе ТехЕСо1ог ( ВСВ (0, 0, 0)); 
сорурС.В1ЕВ1Е { м 1Х, м 1, м Па, м 1Незоре, вас, м 1х, шту, 
ЗВСАМО) ; 
соруОс.В1ЕВ1Е (0, 0, 1сх, 1су, ртпбс, 0, 0, $ВСРАТМТ); 
// копируем данные маски в выходной контекст 
рочЕрС->В1В1 (х, у, 1сх, 1су, &сорурСс, 0, 0, $ЗВССОРУ); 
// выбираем полученные объекты изображений 
СорУБС. бе1есеОБ]есе ( епрСорувВМР); 
Ас.Зе1есОБЗесе ( ФепрВМР); 
} 
// функция обратного вызова для обработки событий таймера 
%014 САБЪВАСК САУТ :: ОрдафеР1ау ( НИМО ВИпа, отмт, отмт, рмово) 
{ 
САУТ* рАУТ = ( САУГ*) С\аа :: ЕгошНапа1е ( №Мла); 
// если указатель пустой, выходим 
1Е ( РАУГТ == МОШЬ) гкебокп; 
// если достигнут конец видеоданных, останавливаем игру 
1Е ( ++ рАУТ->ю абагРгаше >= ( ОТМТ) рАУТ->и_СоппЕЕгаме) 
{ 
// обнуляем номер текущего фрейма 
РАУТ->т аСигЕкаще = 0; 
РАУТ->5®ор (); 
гебагп; 
} 
// выводим следующий кадр изображения 
РАУТ->Гпуа11Ча%е (); 
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// обработчик сообщения ММ РЕЗТВОУ 
уо1А САУТ :: Опрезбкоу () 
{ 
ЗЕор 0; 
} 
// обработчик сообщения ИМ РАТМТ 
уо1А САУТ :: ОпРа1п® ()} 
| . 
// создаем контекст для рисования и выводим очередной кадр 
СРазпЕ С ас ( 51$); 
1Е ( м р5Егеам) ЗПомРгаще ( &ас); 


// функция для загрузки файла в формате АУТ 
116 САУТ :: Тоаа ( ПРСТЗТВ 1рз2АУТЕ11е) 
{ 
СС11еп ОС ас ( 151$); 
ВЕСТ гесё; 
ТОМС 1Ъепай АУТ = 01; 
а х=О0, у=0; 
106 1Сепбекх = 0, 1Сеплфеку = 0; 
0ЕН=0, И=0; 
// обнуляем поля структуры АУТЗТВЕАМТМЕО 
петзее ( &АУГ1пЕо, 0, з1хеоЕЁ ( АУТЗТВЕАМТМЕО)); 
// если видеопоток открыт, закрываем его 





1Е ( м р5Егеам) 
{ 
ЕгееАУТ (); 
11161а117еАУт (); 
} 
// получаем размеры клиентской области окна 
СеесС11ел*ВесЕ ( &гес®); 
// вычисляем высоту и ширину клиентской области окна 
Н = гес®.БоЕбом - гес®.®ор; 
И = гесё.г1аЬе - гес®.1еЕф; 





// открываем видеопоток 
1Е ( АУТ5ЕгеатОрепЕгомЕ11е ( бп р5егеам, 1рзгАУТЕ1е, 
зЕгеапеуреутрЕо, 0, ОЕ ВАЕАР | ОЕ _$НАВЕ ЕХСТОЗТУЕ, МОБ) ) 


п рсгеам = МО; 
тебаги -1[.; // не удалось открыть поток 
} 
// определяем полное число фреймов в потоке 
ш СоппЕЕгаме = АУТ5сгеатЪелаеВ ( м рб&гкеам); 


} 
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// подготавливаем обработчик фреймов 

п рЕкаме = АУТ5тгеатбе{ЕгатеОрел ( м р5егеам, МОП); 

// получаем время конца потока 

1ЪепорСАУТ = АУТ5$ геамЕлаТ1те ( ш рб&гкеам); 

// вычисляем время смены кадров 

м чТ1мег = ( ОТМТ) ( 1ТепабЕАУТ / м СочпеРгаме); 

// получаем информацию о потоке 

АУТ геатТпЕо ( м р5Егеаш, &АУТ1пЕо, з12еоЕЁ ( АУТЗТВЕАМТМЕО)); 
// вычисляем размер видеоизображения 


х = АУТ1аЕо. ксЕкаще. г19ре - АУТ1аЕо.гсЕгапе .1еЕ*; 
у = АУТ11Ео.гсЕгаще.рос$фом - АУТапо.гсЕкаме. вор; 
// вычисляем координаты для центровки изображения 
1СепбекХ = ( (М>х) ? ((И-х /2):0; 
1Сепбеку = ( (Н>Уу) ? ((Н-Уу)) /2:0); 


// сохраняем полученные значения 

м 1Х = 1Сеащегх; 

ш_1У = 1Сещегу; 

м ПТАЕН = х; 

м 1Не19ье = у; 

// создаем совместимый контекст для вывода 

м ОС.Сгеа&еСотра®1ю1ерС ( &9с); 

п ВМРВСК.Сгеа&еСопра®1ю1еВ1тар ( &ас, И, Н); 

п ВМРТЕМР = м ОС. бе1есеОБ)есе { &м ВМРВСВ); 

// закрашиваем клиентскую область стандартным цветом 
м_0С.Е11150119Вес® ( &гес®, ::СеббузСо1ог ( СОШОК_МТМРОЙ)); 


// функция для установки цвета маски 
уо1а САУТ :: ЗесСо1охМазк ( СОТОВВЕЕ со]1ог} 


{ 


} 


п СоТогМазк = со1ог; 


// функция для запуска процесса воспроизведения 
ВООТ, САУТ :: Р1ау () 


{ 


// если воспроизведение уже идет, выходим 
1Е (м ЪР1ау) 
{ 
п аСигЕгаще = 0; 
гесигл КАЬЗЕ; 
} 


// выводим на зкран первый кадр 


Тлуа11Ча%е (); 
// запускаем таймер 
::сесТ1лег ( СеббаЕеНипа (), ТТМЕВ ОРОАТЕ, м чТлмег, 


( ТТМЕВРВОС) ОрдафеР1ау); 
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// устанавливаем состояние воспроизведения 
п 5Р1ау = ТВОЕ; 
гебагл ТВОЕ; 
} 
// функция для остановки текущего воспроизведения 
ВООГ САУТ :: 56ор () 
{ 
// если воспроизведение уже остановлено, выходим 
1Е ( 'м БР1ау) гебакп ГАЬЗЕ; 
// останавливаем таймер 
:: КТТ ег ( беёбаЁеНита (), ТТМЕВ_ОРРАТЕ); 
// устанавливаем состояние воспроизведения 
п ЪР1ау = РАБЗЕ; 
гебагл ТВОЕ; 


Теперь, когда класс для воспроизведения АУ!-файлов готов, создадим тес- 
товое приложение для проверки его работы. Создайте новый проект с под- 
держкой библиотеки МЕС (МЕС АррУ\У\Мтага (ехе)). Введите название проек- 
та, например \У!4ео. В первом окне мастера выберите диалоговое приложе- 
ние (Озю? Ба5ед). В следующем окне мастера оставьте установленным 
только флаг 30 соп@го5. Далее нажимайте кнопки Мехё и Еши5В, пока мас- 
тер не создаст каркас программы. В редакторе ресурсов добавьте на ваше 
диалоговое окно кнопки Е0а6 Еще, Р]ау, З®юр и удалите кнопку ОК. В каче- 
стве окна для вывода изображения используйте элемент управления Эйс 
Тех Присвойте ему уникальный идентификатор, например, трс_УтоЕС. 
Именно в этой области и будет осуществляться вывод видеоданных. Кнопка 
Гоа Ее позволит выбрать А\У[-файл на диске и загрузить его в программу. 


Скопируйте файлы класса сАУТ в папку вашего тестового проекта. В файл 
объявлений для диалогового окна (например, У!4ео П.В) запишите ссылку 
на класс саУТ, как показано в листинге 5.8. 





Листинг 5.8. Файл Маео б.н 
// перед объявлением класса добавьте ссылку на файл САУТ.Н 
#1пс1о9е "АУТ. БВ" 
// далее следует каркас класса СУ14ео019 Я91а1о9 
с1аз$ СУ1аеор19 : раЮ11с СО1а1о9 
{ 
// Сопз&касЕ1оп 
риь11с: 
Су1Я9ео013 ( СМпа* рРагепе = МО); // эзфапаага сопзёгасфог 
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// Р1а1од Рафа 
// { { АЕХ ОАТА ( Су19ео019) 
епим { ТОО = ТОО УТОЕО ОТАБОС }; 
// МОТЕ: Ее С1аз$М1така м111 ааа Чаба мепрегз Веге 
// } } АЕХ РАТА 
// С1аззМ1гахА депегакея у1гблаа1 Еопс®1оп оуегг19ез 
// { { АЕХ_УТВТОАЬ ({ Су1Чеор19) 
ргобес*еа: 
// ООХ/ОБУ 5аррогЕ 
У1гЕоа1 \у014 РорабаЕхсВапае ( СРакаЕхсрапде* рПХ); 
// } } АБХ УТВТОАЬ 
// Пор1етелеа® 1 оп 
рхобесфеа: 
НТСОМ ш_ИТсоп; 
// Седегафе4 пеззаде тар ЕопсЕ1оп$ 
// { { АЕХ_М8б { СУфаеор19) 
У1гбаа1 ВОО Оп1п101а109 (); 
аЁх пз9 уо1а ОпРа1п® (); 
аЕх пз9 НСОВЗОВ ОпОцегургаяаТсоп (); 





аЁх_пзд9 уо1А ОпР1Тау (); 
ах п5а уо1а ОпбЕор (); 
аёх пза у01А ОпОреп (); 
// } } АЕХ_М86 
РЕСЪАВЕ_МЕЗЗАСЕ МАР () 
ре1уаее: 
// объявим наш класс САУТ 
САУТ п АУТ; 
}; 


Файл У!4еоП!2.срр генерируется мастером автоматически и имеет стандарт- 
ный для диалогового приложения вид. Полный листинг этого файла можно 
найти на диске, прилагаемом к книге. 


Добавьте в функцию инициализации диалога (в файле \У!4ео0О]в.срр) код, 
как показано в листинге 5.9. 


Листинг 5.9. Функция Оптп1 Оз а1оч4 () 





ВООГ Су1аео019 :: ОпТп1ЕО1а1о4 () 
{ 
СЯ1а1о49 :: ОпТп1Е01а109 (); 
// Зеф Ете 1соп Рог 1$ Ч41а1о9. ТЬе Егамемогк аоез 515 
// аабота&1са11у мреп бе арр11саЕ1ол'$ па1фп и1паом 
// 15 по а Я1а1о9 
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ЗееТсол ( м _ИТсоп, ТКОЕ); // 5её Ь1д 1соп 

ЗееТсоп ( м БТсоп, ЕАЬЗЕ); // 5её зша11 1соп 

// ТОРО; АЯЯ ехёгка 1п161а112аб1оп Пеге 

// добавляем обработку событий через класс Сита 

п АУТ. 5ирс1аз30191Т6ет { ТРС УТОЕО, 115$); 

тееагп ТВОЕ; // гебогп ТКОЁЕ 001езз уой зе {ре Еоса5 о а сопёго! 


После этого следует написать код для обработки нажатий кнопок Рау, Эр 
и Еоа8 ЕПе так, как это сделано в листинге 5.10. 





// функция для открытия и загрузки файла АУТ 
уо1А Су1аеор19 :: ОпОреп () 
{ 
СЕ11е01а1одч 913 ( ТВОЕ, МОШЬ, "*.ау1", ОЕМ_ НТРЕВЕАРОМГУ | 
ОЕМ ЕТЬЕМОЗТЕХТ5Т, "АУТ Е11ез ( *.а\1) |*.ау1 ||", 513); 
// выводим на экран диалоговое окно для открытия файлов | 
1Е ( ТООК == 919.0оМода1 ()) 
{ 
// получаем имя выбранного файла 
п_ АУТ.Гоаа (919.СесРаЕПМаме ()); 
// устанавливаем цвет маски А\УТ-файла, например черный 
п АУТ. бесСо1оЕМазк { ВСВ (0, 0, 0)); 
} 
} 
// обработка нажатия кнопки Р1ау 
у01А Су19еор19 :: ОпР1ау () 
{ 
ш АУГ.Р1ау (); 
} 
// обработка нажатия кнопки 5 ор 
У01А Су1аеор19 :: Опббор () 
{ 
м АУТ. 56ор (); 


Функция зефСо1охмазк позволяет установить цвет маски изображения. Дела- 
ется это для того, чтобы фон окна вывода совпадал с фоном видеопотока. 
Если для вас это не принципиально, данную функцию можно не вызывать. 
Скомпилируйте программу и проверьте ее в работе. Сразу замечу, что про- 
сматривать можно только стандартные АУ!-файлы. Если же вы захотите ра- 
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ботать с любыми А\|[-файлами, в класс саУТ следует добавить набор функ- 
ций для декомпрессии видеоданных с использованием различных кодеков, 
установленных в системе. Как правило, для этого достаточно всего несколь- 
ко базовых функций и макрокоманд: 


О тсресопргеззОреп. Открывает декомпрессор, совместимый с указанным 
форматом; 


О г:сресопргезз. Производит декомпрессию одного фрейма; 
О тсс1озе. Служит для закрытия компрессора и декомпрессора. 


Программирование функций компрессии АУ!-файлов выходит за рамки 
данной книги и здесь не рассматривается. Если вас интересует данная тема, 
ознакомьтесь с документацией, предоставляемой фирмой М!сгозой. 


ГЛАВА 6 


Звуковая карта 


Появление звуковых карт по праву может считаться началом создания пол- 
ноценных мультимедийных компьютеров. Если раньше для извлечения зву- 
ков использовался системный динамик (спикер), который звучал на уровне 
“пустой консервной банки", то сейчас звуковой модуль представляет собой 
сложнейшее аналого-цифровое устройство. В состав современных звуковых 
карт непременно входят следующие компоненты: 


й ОЗР (Пипа! Зоипа Ргосеззог) — звуковой процессор; 
П Мхег — микшер; 





П МГ (МиясаЕ шзгитепе Оуэна! Ниегасе) интерфейс. 


Каждый из этих компонентов имеет собственные порты управления и отве- 
чает за конкретные задачи. К сожалению, звуковые карты не имеют жестко 
закрепленных портов ввода-вывода, что создает определенные проблемы не 
только программистам, но и настройщикам компьютерного оборудования. 
В ранних версиях \!!190\$ приходилось вручную устанавливать параметры 
звуковой платы, исходя из общей конфигурации оборудования. Для этого 
в файл ашюоехес.ба!Е добавлялась строка следующего вида: 


ЗЕТ ВТАЗТЕВ=А220 15 01 [ Н5 М220 Р330 ] 


Здесь: 
П ^— номер порта ввода-вывода. 
0 : — номер выделенного прерывания. 


П с — номер выбранного 8-битного канала ОМА (ОиесЕ Метогу Ассез$ — 
прямой доступ к памяти). 


0 н— номер выбранного 16-битного канала ОМА. 





П м— номер порта ввода-вывода для микшера. 
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О Р — номер порта ввода-вывода для МРО-401 (это один из режимов рабо- 
ты интерфейса МОТ. 


Весь рассматриваемый в этой главе материал ориентирован на использова- 
ние перечисленных ниже типов звуковых карт: 


С Зоипа ВЙа%ег версии 1.5 (5В 1.5); 

О $оипа ВЙаяег версии 2.0 (5$В 2.0}; 

С $оипа Вйа$ег версии 2.0 с подключением СО (5В 2.0СО); 

О Зоипа Ва$ег Рго ($ВРКО}; 

О Зоипа Начег 16 (5В 16); 

О $оина Начег 16 с расширенным сигнальным процессором (АЗР). 


Еще раз повторю, что программирование звуковых карт несколько сложнее 
других устройств, поскольку нет единого стандарта, а также не предусмот- 
рена универсальная поддержка через В1О0$, тем не менее, я приведу не- 
сколько специфических функций В1О$ для поддержки звуковых плат. 


В общем, как и ранее, представим весь материал в виде нескольких общих 
тем: 


1. Использование функций В1О$. 
2. Использование аппаратных портов. 
3. Использование интерфейса \\!1132 АР. 


6.1. Использование функций В10$ 


Поскольку полноценная поддержка звуковых плат в ВЮ5$ попросту отсутст- 
вует, разберем несколько специфических функций, использующих (далеко 
не везде) возможности драйвера ЗВЕМ (Зоипа ВЙаяег Егедиепсу Модайоп). 
Для его работы используется прерывание :пх 805. Приведем список основ- 
ных функций: 


00001 — получить версию; 

0001н — установить адрес байта состояния; 
0002. — загрузить таблицу инструментов; 
00031 — установить частоту системных часов; 
0004. — установить частоту для драйвера; 
00051 — выполнить транспонирование; 

0006ь — начать воспроизведение; 

0007. — остановить воспроизведение; 


ооо ооооосо 


00082 — выполнить сброс драйвера; 
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О 0009. — приостановить воспроизведение (пауза); 
С о00дь — продолжить воспроизведение после паузы. 


6.1.1. Функция 00001 


Функция позволяет получить текущую версию драйвера ЗВЕМ. 
Использование: 

1. В регистр вх следует поместить код функции 00005. 

2. Вызвать прерывание 11% 801. 

Выход: 

После выполнения функции в регистр Ах будет помещен номер версии. 


6.1.2. Функция 00011 


Эта функция позволяет установить адрес байта состояния, куда будет запи- 
сываться результат выполненной операции. 


Использование: 

1. В регистр вх следует поместить код функции 0001н. 
2. В ох: Ах нужно записать байт состояния. 

3. Вызвать прерывание 11% 80%. 


Выход: 
Выходные значения не определены. 


6.1.3. Функция 00021 


Функция позволяет загрузить новую таблицу инструментов. 
Использование: 

1. В регистр вх следует поместить код функции 00025. 

2. В регистр сх следует записать количество инструментов в таблице. 
3. В ох: Ах нужно поместить указатель на таблицу инструментов. 

4. Вызвать прерывание 1пе 808. 

Выход: 

Выходные значения не определены. 


6.1.4. Функция 000ЗР 


Данная функция позволяет установить частоту системных часов. Стандарт- 
ное значение частоты равно 18,2 Гц. 
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Использование: 

1. В регистр вх следует поместить код функции о0003ь. 

2. В Ах следует записать значение делителя частоты. Частота генератора 
равна 1 193 180 Гц. Если разделить это значение на желаемую частоту 


(в герцах}, мы получим значение делителя частоты. Для восстановления 
стандартного значения 18,2 Гц следует записать в этот регистр ЕЕЕЕБ. 


3. Вызвать прерывание 11% 80,. 


Выход: 


Выходные значения не определены. Чтобы восстановить стандартную часто- 
ту, можно, например, использовать код, представленный в листинге 6.1. 





Листинг 6.1. Использование функции 0003ъ 


хог ВХ, ВХ ;} обнуляем регистр 

поу ВХ, 3 ; записываем код функции 0003. 
гоу АХ, ОЕКРГЕЕР; восстанавливаем 18,2 Гц 

106 80В ; вызываем прерывание 


6.1.5. Функция 00041 


Функция позволяет установить значение частоты для драйвера. По умолча- 
нию используется значение 96 Гц. 


Использование: 
1. В регистр вх следует поместить код функции 00045. 


2. В регистр Ах следует записать значение делителя частоты. Определяется 
так же, как и в функции 0003ь. 


3. Вызвать прерывание 1пе 80ь. 


Выход: 
Выходные значения не определены. 


6.1.6. Функция 00058 


Функция позволяет выполнить транспонирование на указанное число полу- 
ТОНОВ. 


Использование: 
1. В регистр вх следует поместить код функции 00058. 
2. В регистр Ах следует записать количество полутонов. 


3. Вызвать прерывание 1пе 80ь. 
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Выход: 


Выходные значения не определены. Например, чтобы транспонировать му- 
зыку на один тон вверх, можно сделать так, как показано в листинге 6.2. 





хог ВХ, ВХ ; обнуляем регистр 

поу ВХ, 5 ; записываем код. функции 00058 

поу АХ, 2 ; два полутона составляют один тон 
30Е 808 ; вызываем прерывание 


6.1.7. Функция 0006Н 


Данная функция предназначена для запуска процесса воспроизведения. 
Использование: 

1. В регистр вх следует поместить код функции 00065. 

2. В ох: Ах следует поместить указатель на блок данных с музыкой. 

3. Вызвать прерывание 1пе 80,. 


Выход: 


В случае успешного завершения в регистр Ах будет помещен результат: 
00001 — операция успешно выполнена, 00015 — идет процесс воспроизве- 
дения. 


6.1.8. Функция 0007В 


Эта функция позволяет остановить воспроизведение музыки. 
Использование: 

1. В регистр вх следует поместить код функции оооть. 

2. Вызвать прерывание 1п% 80,. 


Выход: 


В случае успешного завершения в регистр Ах будет помещен результат: 
00008 — операция успешно выполнена, 00015 — музыка не играет. 


6.1.9. Функция 0008 


Функция позволяет выполнить сброс драйвера и восстановить используе- 
мые настройки по умолчанию. 


Использование: 
|. В регистр вх следует поместить код функции 0008. 


2. Вызвать прерывание 116 808. 
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Выход: 


В случае успешного завершения в регистр Ах будет помещен результат: 
00008 — операция успешно выполнена, 00015 — музыка не играет. 


6.1.10. Функция 00091 


Эта функция позволяет временно приостановить воспроизведение музыки. 
Использование: 

В регистр вх следует поместить код функции 00098. 
2. Вызвать прерывание 11% 801. 


Выход: 


В случае успешного завершения в регистр Ах будет помещен результат: 
0000 — операция успешно выполнена, 0001ь — музыка не играет. Напри- 
мер, чтобы сделать паузу, можно использовать текст листинга 6.3. 


хог ВХ, ВХ ; обнуляем регистр 

хог АХ, АХ ; обнуляем регистр 

пох ВХ, 9 ; записываем код функции 00098 

10 806 ; вызываем прерывание 

стр АХ, 1 ; если музыка не играет, 

3е № РЦЬАУ ; передаем управление обработчику МО РЬАУ 


6.1.11. Функция О00АР 


Функция позволяет продолжить воспроизведение, остановленное функци- 
ей ооо9эн. 


Использование: 
В регистр вх следует поместить код функции 000д». 


2. Вызвать прерывание зп 80н. 


Выход: 


В случае успешного завершения в регистр Ах будет помещен результат: 
00001 — операция успешно выполнена, 0001ь — воспроизведение не было 
приостановлено. 

* * * 


Вот и все функции В1О$, с которыми мне хотелось вас познакомить. Не 
думаю, что эти сведения будут всегда полезны на практике, но помогут вам 
в дальнейшем (если появится полноценная поддержка В1Ю5$) легко разо- 
браться с новыми возможностями. 
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6.2. Использование портов 


Поскольку современная звуковая плата состоит из нескольких модулей, мы 
рассмотрим программирование каждого из них в отдельности. Сегодня наи- 
более популярны у пользователей звуковые платы фирмы Сгеайуе. Благода- 
ря современным технологиям, этой фирме первой удалось выпустить на 
рынок относительно недорогие модели звуковых плат, поддерживающие не 
только высококачественный звук, но и потрясающие возможности МШ| 
для профессиональной работы с музыкой. 


Основой звуковых плат является звуковой процессор (О$ЗР), позволяющий 
записывать и воспроизводить звуковой сигнал с различных источников: 
цифровых и аналоговых. Как правило, он поддерживает 8-ми и 16-разряд- 
ный (и более) цифровой звук, работает в моно- и стереорежимах, дуплекс- 
ном режиме (воспроизведение и запись сигнала одновременно). Кроме это- 
го, полностью реализована декомпрессия (АОРСМ — Адариуе П!егепиа! 
Ризе Соде Мо4ЩаНноп) звука в реальном времени. 


Встроенный модуль микшера управляет уровнем громкости доступных ка- 
налов, позволяет выбирать активный канал для записи и воспроизведения 
звука. Современные микшеры поддерживают достаточное количество мик- 
рофонных, цифровых и линейных каналов. 


Интерфейс МОТ интересен в первую очередь музыкантам, поскольку по- 
зволяет писать на компьютере полноценную партитуру для своих произве- 
дений, а также подключать внешние устройства (например, синтезатор). 
Правда, чтобы подключить внешний музыкальный инструмент или какой- 
либо модуль, понадобится дополнительный переходник. Это необходимо 
для правильной развязки сигналов по питанию. Думаю, музыкантам это из- 
вестно и так, а нам вряд ли пригодится. Замечу только, что интерфейс 
МШГ использует общий разъем с джойстиком (15 контактов). 


Итак, рассмотрим программирование основных модулей звуковой платы: 
1. Цифровой процессор (О$Р). 

2. Микшер. 

3. Интерфейс МПО. 


6.2.1. Цифровой процессор 


Цифровой процессор выполняет основную часть обработки звукового сиг- 
нала. Для ускорения работы О$ЗР может задействовать контроллер прямого 
доступа к памяти (ОМА). ОЗР используется для следующих операций: 


О запись и воспроизведение моно- или стереозвука с разрядностью 8 и 
16 бит: 
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@ управление частотой дискретизации; 

О в режиме эмуляции Зоипа Еа%ег декомпрессия АБРСМ по формулам 
4:13:1и2: 1; 

О поддержка для боипа В!ачег 16 расширенной обработки сигнала (А$Р): 

О управление ЦАП спикера; 

О управление режимами передачи данных посредством каналов ОМА. 

Для доступа к О$Р используются следующие базовые порты: 


О 2х6в. Используется только для записи. Позволяет выполнить программ- 
ный сброс процессора и установить заданные по умолчанию параметры; 


О 2хАь. Используется только для чтения. Позволяет читать данные из ОЗР; 


О 2хсь. Используется для операций записи и чтения. В режиме записи яв- 
ляется командным и позволяет посылать ОЗР различные управляющие 
команды или данные. В режиме чтения через этот порт считывается”со- 
стояние готовности О$Р к приему команды; 


С 2хЕв. Используется только для чтения. Позволяет проверить готовность 
ОЗР для передачи данных. 


Символ х (икс) указывает на возможные варианты адресации портов для 
реального компьютера: 2101, 2208, 2308, 240%, 2508, 2608 и 2805. Например, 
если для звуковой платы выбран порт 2201, управлять ОЗР можно через 
порт 2265. 


А теперь разберем работу с этими портами подробнее. 


6.2.1.1. Порт 2х6Н 


Порт позволяет сбросить О$Р и инициализировать значения по умолчанию. 
Следует обязательно выполнять эту операцию перед началом работы с про- 
пессором. Процедура сброса должна соответствовать определенной последо- 
вательности действий: 


1. В порт 2х6ь записывается число | и выдерживается пауза минимум в 
3 мкс. 


2. В порт 2х6ь записывается число 0. 


Проверяется порт 2хЕв для подтверждения полученных данных. Если 
бит 7 будет установлен в 1, данные получены. 


4. Опрашивается порт 2хАн. Если значение равно одав, значит ОЗР успешно 
сброшен, иначе можно предположить, что ОЗР отсутствует. Время опро- 
са должно быть не менее 100 мкс. 


Рассмотрим пример кода для инициализации ОЗР через порт 2265 (лис- 
тинг 6.4). 
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поу ПОХ, 226. ; адрес порта 


пох АГ, 1 ; начало инициализации 

оиЕ ОХ, АБ ; записываем значение в порт 2268 

зир АБ, АБ ; устанавливаем задержку 

@Че1ау: 

Чес АБ ; уменьшаем значение на 1 

)12 @ае1ау ; если не 0, повторяем 

очЕ ОХ, АБ ; записываем в порт значение 0 

зир СХ, СХ ; устанавливаем количество опросов порта 22ЕВ 
@среск: 


поу ОХ, 22ЕБ ; адрес порта 

11 АБ, ОХ ; читаем значение из порта 22ЕВ 

апа АГ, 808 ; проверяем наличие данных 

]2 @пехесВеск; если бит 7 равен 0, делаем новую попытку 


заь о, 4 ; читаем данные из порта 22АВ 
11 АБ, ОХ ; получаем значение 

спр АГ, ОААР ; код подтверждения получен 
3е @ЕЖТ о; выходим из процедуры 
@пехесвеск: 


]1оор @спеск ; повторяем попытку 


Аналогичный пример для С++ представлен в листинге 6.5. 


: Пистинг 6.5. Инициализация ОЗР в С++ 





// пример функции для инициализации ОР 
Боо1 Кезекр5Р ( 116 1ВазеРог®) 
{ 
ОМОВО ЧмВезу1Е = 0; // переменная для хранения результата 
106 1Т]мема1е = 65535; 
// записываем в порт 1 
оцЕРоке ( 1ВазеРог® + 6, 0х01, 1); 
// задержка 1 мс 
З1еер (1); 
// записываем в порт 0 
очЕРоге ({ 1ВазеРог® + 6, 0хО00, 1); 
// проверяем наличие данных и результат операции 
м51]е ( -- 1Тмема1® > 0) 
{ 
// читаем состояние порта 2хЕВ 
3пРогЕ ( 1ВазеРоге + ОхОЕ, &ЧмВези1%, 1); 
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1Е ( ( 9мВезо16 & 0х80) == 0х01) 
{ 
// читаем порт 2хАВ 
Бог ( 116 1 = 65000; 1>0; 1 --) 
{ 
1пРогё ( 1ВазеРоге + 0ОхОА, &ЧмВези1е, 1); 
1Е ( дмВезо1& == ОхАА) гебоагл 6гие; // О5Р найден 


} 
// БЗР не обнаружен 
гебати ЁЕа15е; 


6.2.1.2. Порт 2хАВ 


Этот порт используется только для чтения данных из О$Р. Перед тем как 
прочитать данные из этого порта, следует убедиться, что бит 7 в порту ста- 
туса (2хЕв) установлен в 1. Это гарантирует наличие данных в 2хАь, после 
чего их можно прочитать. Базовый пример работы с портом 22Ав приведен 
в листинге 6.6. 


Листинг 6.6. Чтение данных из порта 22Ав 


поу ОХ, 22ЕВ ; адрес порта 22ЕВ 
@гереае: 

11 АБ, ОХ ; читаем порт статуса 
ог АБ, АБ ; проверяем бит 7 

)п$ @хереаЕ ; данных пока нет 
поу ОХ, 22АБ ; адрес порта 22АБ 

10 АБ, ОХ ; читаем данные 


Аналогичный пример для С++ показан в листинге 6.7. 





// функция для чтения данных из ОЗР 
и7$1апеЯ сваг ВКеаар$Р { 116 1ВазеРотг®) 
{ 


ОМОВР ЧмВез01е = 0; // переменная для хранения результата 
106 1Туиема1е = 50000; 
у111е ( -- 1Тшлема1е > 0) 

{ 
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// читаем состояние порта 2хЕБ 
1пРогЕ ( 1ВазеРогЕ + ОхОЕ, &АмВези]1%, 1); 
1Е ( ( Чивези1е & 0х80) == 0х01) Ьгеак; 
// закончилось время ожидания 
зЁ ( 1Тулемате < 1) геботп № _ТТМЕ; 
} 

// читаем данные из порта 22АВ 

@мВези16 = 0; 

1пРогф ( 1ВазеРоге + 0ОхОА, &АчВези1е, 1); 

хебитп (ипз1апеЯ срах) Я9мВези1{; 


6.2.1.3. Порт 2хСВ 


В режиме записи порт позволяет записать управляющую команду О$Р и 
дополнительные аргументы, а в режиме чтения проверяет готовность ОЗР 
к приему команды. Если бит 7 сброшен в 0, значит О$Р готов к приему 
команд или данных. Рассмотрим пример записи команды Ель в порт 22С5 
(листинг 6.8). 


‚: Листинг 6.8. Запись данных в порт 22Сь 


поу РХ, 22Ср ; адрес порта 22СВ 

@гереа\х: 

11 АБ, ОХ ; читаем порт статуса 

ог АШ, АБ ; проверяем бит 7 

]з @гереае ; данных пока нет 

поу АБ, ОЕ1Р ; команда проверки версии О5Р 
сиё РХ, АБ ; записываем команду в порт 





Аналогичный пример для С++ показан в листинге 6.9. 


Л 





// функция для записи данных в О5Р 
у01а Иг1ферз$Р ( 1пе 1ВазеРог®, ипз1апеЯ сраг иУа1ще) 
{ 


ОМОВО ЧмВези1Е = 0; // переменная для хранения результата 
1пе 1ТипеМма1е = 50000; 
\11е ( -- 1Тмемазе > 0) 


{ 
// читаем состояние порта 2хЕВ 
1пРогеЕ ( 1ВазеРог® + 0хОС, &ЧмВези1е, 1); 
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1Е ( ( ЧмВезо]1 & 0х80) == 0х00) Бтеак; 
// закончилось время ожидания 
1Е ( 1Тинаема1е < 1) гебоагп; 
} 
// записываем команду в порт 22СВ 
очЕРогЕ ( 1ВазеРогЕ + 0х0С, иУа]1ае, 1); 
} 
// вызываем нашу функцию для записи команды Е1Ъ в порт 
Иг1ееруР ( 0х220, 0хЕ1); 





Процессор ОЗР поддерживает набор управляющих команд. Все они пере- 
даются через порт 2хсь. Многие из них имеют дополнительные аргументы. 
Список команд приведен в табл. 6.1. 


Таблица 6.1. Команды ОЗР 


Ко 
команды Описание 

10% Прямое воспроизведение 8-битного цифрового звука 

14В Воспроизведение 8-битного цифрового звука через канал ОМА 

161 Воспроизведение 2-битного АОРСМ через канал ОМА 

17Ь Воспроизведение 2-битного АОРСМ через канал ОМА с пустым байтом 

1св Воспроизведение 8-битного цифрового звука через канал ОМА с авто- 
инициализацией 

ТЕР Воспроизведение 2-битного АПРСМ через канал ОМА с автоинициали- 
зацией 

208 Прямое чтение 8-битного цифрового звука 

245 Чтение 8-битного цифрового звука через канал ОМА 

2СВ Чтение 8-битного цифрового звука через канал ОМА с автоинициали- 
зацией 

зов Чтение в режиме МО! 

318 Чтение в режиме МП! с использованием прерывания 

Зав Режим чтения и записи для ЦАВТ (поллинг) 

358 Режим чтения и записи для ЦААТ с использованием прерывания 

368 Режим чтения и записи для ЧАВТ (поллинг с корректировкой по вре- 
мени) 

З7В Режим чтения и записи для ЧААТ с использованием прерывания и 


корректировкой по времени 


38В Запись в режиме МП! 
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Код 
команды 


408 
418 
428 
488 
748 
758 
768 
778 


708 
7ЕВ 


вов 


90 


918 


98 В 


АО 
АВ 
Рон 
218 
ЗВ 
р4В 
258 
8591 
о8Н 
р9в 
РАВ 


Е1В 


Таблица 6.1 (окончание) 


Описание 


Установка временной константы для передачи звуковых данных 
Установка частоты дискретизации для воспроизведения 

Установка частоты дискретизации для записи 

Установка размера блока данных 

Воспроизведение 4-битного АБРСМ через канал ОМА 
Воспроизведение 4-битного АОРСМ через канал ОМА с пустым байтом 
Воспроизведение 3З-битного АОРСМ через канал ОМА 
Воспроизведение З-битного АОРСМ через канал ОМА с пустым байтом 


Воспроизведение 4-битного АВРСМ через канал ОМА с пустым байтом 
и автоинициализацией 


Воспроизведение 3З-битного АБРСМ через канал ОМА с пустым байтом 
и автоинициализацией 


Установка паузы для ЦАП ввода-вывода 


Ускоренное воспроизведение 8-битного цифрового звука через канал 
ОМА с автоинициализацией 


Ускоренная запись 8-битного цифрового звука через канал ОМА 


Ускоренная запись 8-битного цифрового звука через канал ОМА 
с автоинициализацией 


Установка монорежима для записи 

Установка стереорежима для записи 

Приостановить 8-битный ввод-вывод через ОМА 

Включить динамик 

Выключить динамик 

Продолжить 8-битный ввод-вывод через ОМА 

Приостановить 16-битный ввод-вывод через ОМА 

Продолжить 16-битный ввод-вывод через ОМА 

Получить состояние динамика 

Завершение 16-битного ввода-вывода через ОМА с автоинициализацией 
Завершение 8-битного ввода-вывода через ОМА с автоинициализацией 


Получить номер версии ОЗР 





Разберем наиболее часто используемые команды О$Р подробнее. 
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Команда 10Р 


Команда поддерживает воспроизведение несжатого 8-битного звука. За один 
раз она выводит один байт данных. 


Использование: 

1. Записать в порт 2хсв значение 105. 

2. Записать в порт байт данных. 

3. Подождать определенное время и перейти к первому пункту. 

Следует повторять эти действия, пока не будут переданы все байты данных. 


Команда 14Р 


Эта команда поддерживает воспроизведение 8-битных оцифрованных дан- 
ных через установленный канал ОМА. Она имеет два аргумента (младший 
и старший байты), определяющих полную длину проигрываемого участка 
данных минус единица. 


Использование: 

Установить обработчик прерывания. 

Установить частоту дискретизации (команда 40ъ). 
Записать в порт команду руль. 

Установить размер блока данных для ОМА. 
Записать в порт значение 14ъ и аргументы. 


Проверить порт 2хЕЪ. 


яя - 


Записать в порт команду рзь. 


Команда 161 


Команда поддерживает 2-битный АОРСМ через канал ОМА. В отличие от 
предыдущей команды, она работает со сжатыми данными АОРСМ. Команда 
имеет два аргумента (младший и старший байты), определяющих полную 
длину передаваемых данных в байтах минус единица. В качестве первого 
байта данных должен быть передан пустой байт. 


Команда 17В 
Данная команда поддерживает 2-битный АОРСМ через канал ОМА, но 
первый передаваемый байт должен быть пустым для обработки АОРСМ. 


Команда 201 


Команда поддерживает прямое чтение 8-битного цифрового звука из АЦП. 
Говоря проще, данная команда позволяет записать оцифрованный звук и 
сохранить его на диск. 
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Использование: 
1. Записать в порт значение 20. 


2. Считать из порта один байт. 
3. Подождать определенное время и перейти к первому пункту. 


Следует повторять эти действия, пока не будут считаны все данные. 


Команда 301 

Эта команда позволяет прочитать данные из порта МО. 
Использование: 

|. Записать в порт значение зоь. 


2. Опросить ОЗР на наличие данных МЕ. 


Команда 38В 

Команда позволяет записать данные в порт МИГ. 
Использование: 

|. Записать в порт значение 385. 


2. Записать в порт данные МОЕ. 


Команда 401 


Данная команда позволяет установить значение временной константы, ко- 
торая может быть высчитана следующим образом: 


временная константа = 65 536 — 256 000 000 / (число каналов * частота дис- 
кретизации). 


Для монорежима используется один канал, а для стерео — два. 

Использование: 

1. Записать в порт значение 40ъ. 

2. Записать в порт значение константы (используется только старший 
байт). 

Команда 47Н 


Команда позволяет установить частоту дискретизации для воспроизведения 
звуковых данных. Допустимые значения частоты лежат в диапазоне от 5 000 
до 45 000 Гц включительно. 


Использование: 
1. Записать в Порт значение 41ъ. 
2. Записать в порт старший байт частоты. 


3. Записать в порт младший байт частоты. 
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Команда 428 


Эта команда позволяет установить частоту дискретизации для записи звуко- 
вых данных. Допустимые значения частоты лежат в диапазоне от 5 000 
до 45 000 Гц включительно. 


Использование: 
1. Записать в порт значение 42ъ. 
2. Записать в порт старший байт частоты. 


3. Записать в порт младший байт частоты. 


Команда 48В 


Команда позволяет установить размер одного блока для ускоренного ре- 
жима передачи данных ОМА. Размер блока измеряется в байтах минус еди- 
ница. 


Использование: 
1. Записать в порт значение 48ь. 
2. Записать в порт младший байт. 


3. Записать в порт старший байт. 


Команда 808 


Эта команда позволяет установить продолжительность паузы, которая изме- 
ряется в выборках минус единица. С помощью данной команды можно реа- 
лизовать режим тишины — полное отсутствие уровня сигнала. Команда ис- 
пользует текущее значение частоты дискретизации. 


Использование: 

1. Записать в порт значение вов. 
2. Записать в порт младший байт. 
3. Записать в порт старший байт. 


Команда АОН 

Команда позволяет установить монорежим для записи. По умолчанию ис- 
пользуется монорежим. 

Команда АТВ 


Эта команда позволяет установить стереорежим для записи. 


Команда О7В 


Команда позволяет установить связь между цифровым выходом и входом 
усилителя. Для завершения команды необходимо максимум 112 мс. 
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Команда ОЗВ 


Команда позволяет разорвать связь между цифровым выходом и входом 
усилителя. Для завершения команды необходимо максимум 220 мс. 


Команда О8В 


Команда позволяет получить текущее состояние канала связи между цифро- 
вым выходом и входом усилителя. Если связи нет, возвращается оон, ина- 
че — ЕЕЪ. 


Команда Е7ТВ 


Команда позволяет получить версию установленного О$Р. После выполне- 
ния команды будут получены два байта: первый определяет старший (пза)ог) 
номер версии, второй содержит младший (ттог) номер. 

* * * 


Рассмотрим несколько примеров работы с ОЗР. Напишем код для включе- 
ния динамика (листинг 6.10). 





поу ОХ, 22Ср ; адрес порта 22СВ 

@тереас: 

0 АБ, ОХ ; читаем порт статуса 

ог АБ, АБ ; проверяем бит 7 

33 @хереаЕ ; данных пока нет 

поу А, 001Ъ ; включаем динамик 

опЕ ОХ, АБ ; записываем команду в порт 


Аналогичный пример для С++ представлен в листинге 6.11. 








// вызываем нашу функцию для записи команды 01 в порт 
ИглеербР ( 0х220, 0х1); 


А теперь попробуем установить частоту дискретизации для воспроизведения 
44 100 Гц (0Ас44ъ) так, как это сделано в листинге 6.12. 





Листинг 6.12. Установка новой частоты дискретизации 





мт16ео5Р ргос пеах 

поу ОХ, 22СВ ; адрес порта 22С8 
@хереа\: 

11 АБ, БХ ; читаем порт статуса 





244 Часть {. Работа с аппаратными ресурсами в Ийпаом5 


ог АГ, АБ ; проверяем бит 7 
33 @гереаЕ $; данных пока нет 
поу АГ, ВЫ ; записываем данные 


оцЕ РХ, АБ ; записываем команду в порт 








мх16ер5Р епар 

хог ВХ, ВХ ; обнуляем регистр 

поу ВЬ, 416 ; выбираем команду установки новой частоты 
са11 мх1Еер$ЗР; записываем команду в порт 

поу ВЫ, ОАСР ; сначала пишем старший байт частоты 

са11 мх1Еер5Р; записываем значение в порт 

оу ВЬ, 44 ; потом пишем младший байт частоты 

са11 мх1ер$Р; записываем значение в порт 


Аналогичный пример для С++ показан в листинге 6.13. 


: Листинг 6.13. Установка новой частоты дискретизации в С++ 





// используем нашу функцию для записи значений в порт О5Р 
Мт1сер5Р ( 0х220, 0х41); // код команды 41. 

Ме1еер5Р { 0х220, ОхАС); // старший байт частоты 
Мт16ербР ( 0х220, 0х44); // младший байт частоты 


Для установки ОЗР в 16-битный режим воспроизведения и передачи блока 
данных размером 16 Кб можно использовать код из листинга 6.14. 


Листинг 6.14. Установка 16-битного режима 


игтсео5Р рхгос пеагх 

шоу ОХ, 22Ср ; адрес порта 22СЬ 
@гереа®: 

10 АБ, ОХ ; читаем порт статуса 
ог АБ, АБ ; проверяем бит 7 

33 @гереаЕ ; данных пока нет 





поу АБ, ВЬ ; записываем данные 

ое ОХ, АБ ; записываем команду в порт 
мг1$сер5Р епар 

хог ВХ, ВХ ; обнуляем регистр 

поу ВЬ, ОВОр ; воспроизведение 16-ти бит 
са]11 их1$еб$Р; записываем команду в порт 
поу ВЬ, ЗОв ; стереорежим 

са11 м"г1т$ерзР; записываем команду в порт 
шоу ВЬ, ОРЕБ ; младший байт длины блока 
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са11 мг1Еер$Р; записываем команду в порт 
поу ВЬ, ОЗ ; старший байт длины блока 
са11 их1фер$Р; записываем команду в порт 


Аналогичный пример для С++ показан в листинге 6.15. 

: Листинг 6.15. Установка 16-битного режима в С++ 
// используем нашу функцию для записи значений в порт О$Р 

Ис1сербР ( 0х220, 0хв0); // воспроизведение 16-ти бит 


Ис1серзР ( 0х220, 0х30); // стереорежим 
ИстеерзР ( 0х220, ОхЕг); // младший байт длины блока 
Иг{ерзр ( 0х220, 0х03); // старший байт длины блока 


Длина блока данных в обоих примерах рассчитана умножением числа 16 
на | 024 минус один. Результирующее значение равно 16383 или ЗЕЕЕБ в ше- 
стнадцатеричном исчислении. На этом завершим работу с ОЗР и рассмот- 
рим, как программируется микшер звуковой карты. 


6.2.2. Микшер 


Микшер, как уже было сказано ранее, предназначен для коммутации кана- 
лов, а также для управления громкостью звука этих каналов. Для поддержки 
работы с микшером предназначены следующие порты: 


О 2х4ь — адресный порт. Используется только для записи. Позволяет вы- 
брать номер управляющего регистра; 


О 2х5 — порт данных. Используется для чтения и записи. Позволяет пере- 
давать и получать данные для указанного регистра. 


Для работы с микшером необходимо записать в порт 2хаь номер управляю- 
щего регистра. После этого можно записывать или считывать данные из 
порта 2х5ъ. При изменении отдельных битов управляющего регистра внача- 
ле следует прочитать его значение, а после этого изменить нужный разряд и 
записать значение в порт. Важно соблюдать это правило для совместимости 
с последующими расширениями. Список управляющих регистров приведен 
в табл. 6.2. 


Приведем краткое описание таблицы. 


СП Регистр ов предназначен для сброса микшера. После сброса все регист- 
ры микшера будут установлены по умолчанию. Для выполнения сброса 
достаточно записать любое значение (размером в байт) в этот регистр. 
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Таблица 6.2. Список регистров микшера 


Описание 


[а [за [о 


008 
04В 
ОАВ 


22. 


26. 
28. 


2ЕВ 


св 


ЗОВ 


ЗЕВ 


ЗЕВ 


408 












Сброс микшера 





Громкость ЦАП в левом канале Громкость ЦАП в правом канале 










Общая громкость в левом канале Общая громкость в правом 
канале 


Громкость М] в левом канале Громкость М! в правом канале 
Громкость СО в левом канале Громкость СО в правом канале 


Громкость линейного входа в левом Громкость линейного входа в 


канале правом канале 
Общая громкость в левом канале Резерв 
Общая громкость в правом канале Резерв 
Громкость ЦАП в левом канале Резерв 
Громкость ЦАП в правом канале Резерв 
Громкость МЮ! в левом канале Резерв 
Громкость МП] в правом канале Резерв 
Громкость СО в левом канале Резерв 
Громкость СО в правом канале Резерв 
Громкость линейного входа в левом канале Резерв 
Громкость линейного входа в правом канале Резерв 


Громкость микрофона Резерв 


динамика ПК 
Резерв Управление выходными каналами 
ы 

Резерв Управление входным левым каналом 

м 
Резерв _ Управление входным правым каналом 

м 
УЛВХК Резерв 


УПВХК Резерв 
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Таблица 6.2 (окончание) 








Код Описание 

418 УЛВК Резерв 

428 УПВК Резерв 

43В Резерв АПУ 


44в Уровень высоких частот Резерв 
в левом канале 


458 Уровень высоких частот Резерв 
в правом канале 





460 Уровень низких частот в левом канале | Резерв 


478 Уровень низких частот Резерв 


в правом канале 


С Регистр о4ъь управляет уровнем громкости ЦАП в левом и правом кана- 
лах. Биты 7—4 отвечают за левый канал, а биты 3—0 — за правый. Име- 
ются 16 уровней (от 0 до 15) громкости, где 0 соответствует значению 
-60 дБ, а 15 — ОлБ с шагом’ в 4 дБ. По умолчанию уровень равен 12 
{12 дБ). 


О Регистр одь управляет уровнем громкости микрофона. Используются 
только биты 2—0. Имеются 8 уровней (от 0 до 7) громкости, где 0 соот- 
ветствует значению -—48 дБ, а 7 — ОдБ с шагом в 6 дБ. По умолчанию 
уровень равен 0 (-48 дБ). 


О Регистр 22ь управляет общим уровнем громкости в левом и правом кана- 
лах. Биты 7—4 отвечают за левый канал, а биты 3—0 — за правый. Име- 
ются 16 уровней (от 0 до 15) громкости, где 0 соответствует значению 
-60 дБ, а 15 — ОдБ с шагом в 4 дБ. По умолчанию уровень равен 12 
(12 дБ). 


О Регистр 266 управляет уровнем громкости М] в левом и правом кана- 
лах. Биты 7—4 отвечают за левый канал, а биты 3—0 — за правый. Име- 
ются 16 уровней (от 0 до 15) громкости, где 0 соответствует значению 
—60 дБ, а 15 — ОдБ с шагом в 4 дБ. По умолчанию уровень равен 12 
(12 дБ). 


О Регистр 285 управляет уровнем громкости аудиодиска в левом и правом 
каналах. Биты 7—4 отвечают за левый канал, а биты 3—0 — за правый. 
Имеются 16 уровней (от 0 до 15) громкости, где 0 соответствует значе- 
нию 60 дБ, а 15 — О дБ с шагом в 4 дБ. По умолчанию уровень равен 0 
(-60 дБ). 
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С Регистр 2Ев управляет уровнем громкости линейного входа в левом и 
правом каналах. Биты 7—4 отвечают за левый канал, а биты 3—0 — за 
правый. Имеются 16 уровней (от 0 до 15) громкости, где 0 соответствует 
значению -60 дБ, а 15 — ОДБ с шагом в 4 дБ. По умолчанию уровень 
равен 0 (-60 дБ). 


С Регистр зов управляет общим уровнем громкости в левом канале. Ис- 
пользуются только биты 7—3. Имеются 32 уровня (от 0 до 31) громкости, 
где 0 соответствует значению -62 дБ, а 31 — ОдБ с шагом в 2 дБ. По 
умолчанию уровень равен 24 (-14 дБ). 


С Регистр з1ь управляет общим уровнем громкости в правом канале. Ис- 
пользуются только биты 7—3. Имеются 32 уровня (от 0 до 31) громкости, 
где 0 соответствует значению -62 дБ, а 31 — ОдБ с шагом в 2 дБ. По 
умолчанию уровень равен 24 (-14 дБ). 


С Регистр з2ь управляет уровнем громкости ЦАП в левом канале. Исполь- 
зуются только биты 7—3. Имеются 32 уровня (от 0 до 31) громкости, где 
0 соответствует значению —62 дБ, а 31 — ОдБ с шагом в 2 дБ. По умол- 
чанию уровень равен 24 (-14 дБ). 


С Регистр 33в управляет уровнем громкости ЦАП в правом канале. Ис- 
пользуются только биты 7—3. Имеются 32 уровня (от 0 до 31) громкости, 
где 0 соответствует значению -62 дБ, а 31 — ОдБ с шагом в 2 дБ. По 
умолчанию уровень равен 24 (-14 дБ). 


С Регистр 34в управляет уровнем громкости МТО в левом канале. Исполь- 
зуются только биты 7—3. Имеются 32 уровня (от 0 до 31) громкости, где 
0 соответствует значению —62 дБ, а 31 — ОдБ с шагом в 2 дБ. По умол- 
чанию уровень равен 24 (-14 дБ). 


С Регистр 356 управляет уровнем громкости МШГ в правом канале. Ис- 
пользуются только биты 7—3. Имеются 32 уровня (от 0 до 31) громкости, 
гле 0 соответствует значению -62 дБ, а 31 — О дБ с шагом в 2 дБ. По 
умолчанию уровень равен 24 (-14 дБ). 


С Регистр з6н управляет уровнем громкости аудиодиска в левом канале. 
Используются только биты 7—3. Имеются 32 уровня (от 0 до 31) громко- 
сти, гле 0 соответствует значению -62 дБ, а 31 — О дБ с шагом в 2 дБ. По 
умолчанию уровень равен 0 (-62 дБ). 


С Регистр 37. управляет уровнем громкости аудиодиска в правом канале. 
Используются только биты 7—3. Имеются 32 уровня (от 0 до 31) громко- 
сти, где 0 соответствует значению —62 дБ, а 31 — О дБ с шагом в 2 дБ. По 
умолчанию уровень равен 0 (-62 дБ). 


С Регистр з8ь управляет уровнем громкости линейного входа в левом кана- 
ле. Используются только биты 7—3. Имеются 32 уровня (от 0 до 31) 
громкости, где 0 соответствует значению -62 дБ, а 31 — ОдБ с шагом 
в 2 дБ. По умолчанию уровень равен 0 (-62 дБ). 
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С Регистр з9в управляет уровнем громкости линейного входа в правом ка- 
нале. Используются только биты 7—3. Имеются 32 уровня (от 0 до 31) 
громкости, где 0 соответствует значению —62 дБ, а 31 — ОдБ с шагом 
в 2 дБ. По умолчанию уровень равен 0 (-62 дБ). 


О Регистр зАв управляет уровнем громкости микрофона. Используются 
только биты 7—3. Имеются 32 уровня (от 0 до 31) громкости, где 0 соот- 
ветствует значению -62 дБ, а 31 — ОдБ с шагом в 2 дБ. По умолчанию 
уровень равен 0 (-62 дБ). 


С Регистр звь управляет уровнем громкости динамика ПК. Используются 
только биты 7 и 6. Имеются 4 уровня (от 0 до 3) громкости, где 0 соот- 
ветствует значению -18 дБ, а 3 — ОдБ с шагом в бдБ. По умолчанию 
уровень равен 0 (-18 дБ). 


О Регистр зсв управляет выходными каналами. Используются только биты 
4—0: бит 4 — линейный левый канал, 3 — линейный правый канал, 2 — 
аудио СО левый, | — аудио СО правый, 0 — микрофон. Установка бита 
в 0 позволяет открыть соответствующий канал. По умолчанию значения 
всех битов равны 1 (все закрыты). 


С Регистр зов управляет левыми входными каналами. Используются только 
биты 6—0: бит 6 — МШ[ левый (0), 5 — МШУ правый (0), 4 — линей- 
ный левый (1), 3 — линейный правый (0), 2 — аудио СО левый (1), | — 
аудио СО правый (0), 0 — микрофон (1). Значения по умолчанию указа- 
ны в круглых скобках. Установка бита в 0 позволяет открыть соответст- 
вующий канал. В монорежиме являются единственными каналами для 
ввода данных. 


С] Регистр зкв управляет правыми входными каналами. Используются Толь- 
ко биты 6—0: бит 6 — МШГ левый (0), 5 — МИЛ правый (0), 4 — ли- 
нейный левый (1), 3 — линейный правый (0), 2 — аудио СР левый (1), 
1 — аудио СР правый (0), 0 — микрофон (1). Значения по умолчанию 
указаны в круглых скобках. Установка бита в 0 позволяет открыть соот- 
ветствующий канал. 


О Регистр зкь управляет уровнем усиления в левом входном канале. Ис- 
пользуются только биты 7 и 6. Имеются 4 уровня (от 0 до 3) усиления, 
где 0 соответствует значению 0 дБ, а 3 — 18 дБ с шагом в 6 дБ. По умол- 
чанию уровень равен 0 (0 дБ). 


О Регистр 405 управляет уровнем усиления в правом входном канале. Ис- 
пользуются только биты 7 и 6. Имеются 4 уровня (от 0 до 3) усиления, 
где 0 соответствует значению 0 дБ, а 3 — 18 дБ с шагом в 6 дБ. По умол- 
чанию уровень равен 0 (0 дБ). 


С Регистр 41. управляет уровнем усиления в левом выходном канале. Ис- 
пользуются только биты 7 и 6. Имеются 4 уровня (от 0 до 3) усиления, 
где 0 соответствует значению 0 дБ, а 3 — 18 дБ с шагом в 6 дБ. По умол- 
чанию уровень равен 0 (0 дБ). 
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С Регистр 42ь управляет уровнем усиления в правом выходном канале. Ис- 
пользуются только биты 7 и 6. Имеются 4 уровня (от 0 до 3) усиления, 
где 0 соответствует значению 0 дБ, а 3 — 18 дБ с шагом в 6 дБ. По умол- 
чанию уровень равен 0 (9 дБ). 


С Регистр а4зь управляет автоматической подстройкой уровня усиления 
микрофона. Используется только бит 0. Установка бита в | позволяет 
увеличить уровень на 20 дБ. По умолчанию бит равен 0 (0 дБ). 


С Регистр 44в управляет уровнем высоких частот в левом канале. Исполь- 
зуются только биты 7—4. Имеются 16 уровней. Значения от 0 до 7 уста- 
навливают соответственно значения уровня от -14 дБ до 9 дБ с шагом 
2 дБ. Значения от 8 до 15 устанавливают значения уровня соответственно 
от 0 дБ до 14 дБ с шагом 2 дБ. Но умолчанию используется значение 8 


(0 дБ). 


О Регистр 45ъ управляет уровнем высоких частот в правом канале. Исполь- 
зуются только биты 7—4. Имеются 16 уровней. Значения от 0 до 7 уста- 
навливают значения уровня соответственно от -14 дБ до 0 дБ с шагом 
2 дБ. Значения от 8 до 15 устанавливают значения уровня соответственно 
от 0 дБ до 14 дБ с шагом 2 дБ. По умолчанию используется значение 8 
(0 дБ). 


С Регистр 46 управляет уровнем низких частот в левом канале. Использу- 
ются только биты 7—4. Имеется 16 уровней. Значения от 0 до 7 устанав- 
ливают соответственно значения уровня от -14 дБ до 0 дБ с шагом 2 дБ. 
Значения от 8 до 15 устанавливают значения уровня соответственно от 
0 дБ. до 14 дБ с шагом 2 дБ. По умолчанию используется значение 8 
(0 дБ). 


С Регистр 47ь управляет уровнем низких частот в правом канале. Исполь- 
зуются только биты 7—4. Имеются 16 уровней. Значения от 0 до 7 уста- 
навливают соответственно значения уровня от -14 дБ до 0 дБ с шагом 
2 дБ. Значения от 8 до 15 устанавливают соответственно значения уровня 
от 0 дБ до 14 дБ с шагом 2 дБ. По умолчанию используется значение 8 
(0 дБ). 


С Регистр вон позволяет установить номер прерывания для звуковой карты. 
Используются только биты с 3 по 0: бит 3 — прерывание тво 10, 2 бит — 
тво 7, [ бит — тво 5, 0 бит — тво 2. Следует помнить, что в один момент 
времени может быть установлен только один номер прерывания. Для 
этого нужно записать в соответствующий бит значение 1. Хотя этот ре- 
гистр и управляет общими настройками всей платы, работать с ним нуж- 
но через порты микшера. 


О Регистр 81. позволяет установить номер канала ОМА для звуковой кар- 
ты. Как и предыдущий регистр, он управляет глобальными настройками 
звуковой платы, но адресуется через порты микшера. Формат данного 


Глава 6. Звуковая карта 251 


регистра показан в табл. 6.3. Для выбора нужного канала следует устано- 
вить соответствующий бит в 1. В один момент времени может быть уста- 
новлен только один из трех 16-битных и 8-битных каналов ОМА. Произ- 
водители звуковых плат не рекомендуют изменять значения в регистрах 
805 и 815, а предлагают пользоваться специальными утилитами, входя- 
шими в комплект поставки звуковой платы. Кроме того, эти регистры 
могут использоваться только для РиР (Ри? апа Рау) плат. 


Таблица 6.3. Формат регистра 815 








Канал 
ОМА 


О Регистр 825 предназначен для получения состояния об аппаратном пре- 
рывании звуковой платы. Может применяться для работы со всеми мо- 
дулями звуковой платы: ОЗР, микшером и интерфейсом МРО-401. Рабо- 
та с регистром выполняется через порты микшера. Регистр можно только 
читать. Информационными являются следующие биты: 2 — интерфейс 
МРО-401, | — 16-битный канал ОМА для ввода и вывода, 0 — 8-битный 
канал ОМА для ввода и вывода. Если считываемый бит установлен в 1, 
значит, прерывание было вызвано соответствующим компонентом 
(МРИ-401, ОМА 16-ти бит или ОМА 8-ми бит). Для подтверждения пре- 
рывания следует прочитать один из следующих портов: 2хЕн — для ОМА 
8-ми бит или $В-МШОТ, 2хЕЪ — для 16-ти бит ОМА, зхов — для МРО-401. 


Как видите, управлять микшером не очень сложно. Рассмотрим простой 


пример для установки новых значений уровня общей громкости для левого 
и правого каналов (листинг 6.16). 


; предположим, что микшер доступен через порты 2248 и 2258 
поу ОХ, 2241 ; адресный регистр 
шоу АБ, ЗОБ ; регистр 308 


оф ОХ, АБ ; записываем значение в порт 

1ш1с ОХ ; регистр данных 

пох АГ, 141 ; установим уровень громкости -22 дБ для левого канала 
351 АЦ, 3 ; используются только биты с 7 по 3 


омЕ ПХ, АБ ; записываем значение в порт 
дес ОХ ; адресный регистр 
шоу АГ, 31й ; регистр 311 
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оцЕ ОХ, АБ ; записываем значение в порт 

11с 5Х ; регистр данных 

поу АБ, 14 ; установим уровень громкости -22 дБ для правого канала 
$01 АБ, 3 ; используются только биты с 7 по 3 

оце ОХ, АБ ; записываем значение в порт 


Аналогичный пример для С++ представлен в листинге 6.17. 


Листинг 6.17. Установка общего уровня громкости в С++ 


// функция для записи данных в ОР 
у01а ЗеЕ-МазкетУо1още ( ОМОВР амУа1ает, РМОВР амУа1аеВ) 


{ 
РИОВО аАм\Уа1ае = 0; 
// записываем номер регистра в порт 2248 
очЕРокЕ ( 0х224, 0х30, 1); 
Чм\Уа]ае = ам\Уа1аеф << 3; // используются только биты с 7 по 3 
оПЕРОГЕ ( 0х225, амуа1ае, 1); // левый канал 
// записываем номер регистра в порт 2248 
опЕРоге ( 0х224, 0х31, 1); 
ам\Уа] ие = амУуа]1аеВ << 3; // используются только биты с 7 по 3 
очЕРогЕ ( 0х225, амУа1е, 1); // левый канал 
} 


// установим общий уровень громкости -22 ДБ для обоих каналов 
Зе МазфсетУо ле ( 20, 20); 


А теперь попробуем определить, каким модулем было вызвано последнее 
прерывание (листинг 6.18). 


Листинг 6.18. Определение источника прерывания 


; предположим, что микшер доступен через порты 2248 и 2256 

шоу ОХ, 2248 ; адресный регистр 

шоу АБ, 825 ; регистр 828 

оцЕ ОХ, АБ ; пишем в порт 

11с ОХ ; выбираем порт 2258 

11 АГ, ОХ ; читаем из него байт 

сир АБ, 011 ; ОМА 8-ми бит 

3е ма 8 ; переходим в процедуру Чта_8 и проверяем порт 22ЕБ 
спр АБ, 026 ; ВМА 16-ти бит 

3е Яма 16 ; переходим в процедуру Чта_16 и проверяем порт 22ЕПВ 
спр АБ, 041 ; МРО-401 

)е при 401 ; переходим в процедуру при 401 и проверяем порт Зх0в 
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Для подтверждения прерывания следует прочитать байт из соответствующе- 
го порта (2хЕБ, 2хЕН или зхон), а После этого послать команду завершения 
прерывания в порт программируемого контроллера прерываний. Аналогич- 
ный пример для С++ показан в листинге 6.19. 


Листинг 6.19. Определение источника прерывания в С++ 





// переменная для хранения результата 
ОИОВО @ЧмВези1е = 0; 
// записываем номер регистра 821 в порт 2248 
оцЕРогЕ ( 0х224, 0х82, 1); 
// читаем порт 2258 
1пРогЕ ( 0х225, &амВеза1&, 1); 
// проверяем, чем вызвано прерывание 
зм1есВ ( ЯмВезо14) 
{ 
сазе 1: // ОМА 8-ми бит 
// выполняем какие-либо действия 
ргеак; 
сазе 2: // ОМА 16-ти бит 
// выполняем какие-либо действия 
Ьгеак; 
сазе 4: // интерфейс МРО-401 
// выполняем какие-либо действия 
ргеак; 


Вся информация об устройстве микшера приведена для модуля СТ1745 
фирмы Сгеануе. Если читатель программирует более ранние версии микше- 
ра, то ему следует полагаться на информацию, представленную в табл. 6.4 
и 6.5. 


Таблица 6.4. Список регистров микшера СТ1335 












Код Описание 


регистра 






Общий уровень громкости 
Уровень громкости МПО! 


Уровень громкости 
аудио СО 


Уровень 
громкости ЦАП 
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Приведем краткое описание табл. 6.4. 


С Регистр 00н позволяет сбросить микшер. После сброса все регистры 
микшера будут установлены в значения, используемые по умолчанию. 
Для выполнения сброса достаточно записать любое значение (размером в 
байт) в этот регистр. 


О Регистр 02ь управляет общим уровнем громкости всех каналов. Исполь- 
зуются только биты 3—1. Имеются 8 уровней (от 0 до 7) громкости, где 0 
соответствует значению —46 дБ, а 7 — 0 дБ с нелинейным шагом в 4 дБ. 
По умолчанию уровень равен 4 (-11 дБ). 


С Регистр обь управляет уровнем громкости МТО. Используются только 
биты 3—1. Имеются 8 уровней (от 0 до 7) громкости, где 0 соответствует 
значению -46 дБ, а7 — 0 дБ с нелинейным шагом в 4 дБ. По умолчанию 
уровень равен 4 (-11 дБ). 


С Регистр 08» управляет уровнем громкости аудиодиска. Используются 
только биты 3—1. Имеются 8 уровней (от 0 до 7) громкости, где 0 соот- 
ветствует значению —46 дБ, а 7 — 0 дБ с нелинейным шагом в 4 дБ. По 
умолчанию уровень равен 0 (—-46 дБ). 


С Регистр олдь управляет уровнем громкости ЦАП. Используются только 
биты 2 и 1. Имеются 4 уровня (от 0 до 3) громкости, где 0 соответствует 
значению —46 дБ, а3 — 0 дБ с нелинейным шагом в 7 дБ. По умолчанию 
уровень равен 0 (-46 дБ). 


Таблица 6.5. Список регистров микшера СТ1345 


Код Описание 

00в Сброс микшера 

048 Уровень громкости ЦАП Резерв 
для левого канала для правого канала 

ОАВ Резерв М Резерв 


ме Резерв ВХХФ Резерв |Фильтр |Входной Резерв 
НЧ источник 


228 Общий уровень в левом Резерв | Общий уровень в правом |Резерв 
канале канале 

261 Уровень МО! в левом Резерв |Уровень М! в правом Резерв 
канале канале 

288 Уровень СВ в левом Резерв |Уровень СО в правом Резерв 
канале канале 

2ЕВ Линейный левый канал Резерв |Линейный правый канал Резерв 
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Приведем краткое описание табл. 6.5. 


О Регистр 00» позволяет сбросить микшер. После сброса все регистры 
микшера будут установлены по умолчанию. Для выполнения сброса дос- 
таточно записать любое значение (размером в байт) в этот регистр. 


О Регистр о4в управляет уровнем громкости ЦАП для левого (биты 7—5) и 
правого (биты 3—1) каналов. Имеются 8 уровней (от 0 до 7) громкости, 
где 0 соответствует значению —46 дБ, а 7 — 0 дБ с нелинейным шагом 
в 4 дБ. По умолчанию уровень равен 4 (-11 дБ). 


О Регистр одв управляет уровнем громкости микрофона (биты 2 и 1). Име- 
ются 4 уровня (от 0 до 3) громкости, где 0 соответствует значению 
—46 дБ, а 3 — ОдБ с нелинейным шагом в 7 дБ. По умолчанию уровень 
равен 0 (-46 дБ). 


О Регистр ось имеет следующее назначение: бит 5 управляет состоянием 
входного фильтра: 0 — включен и сигнал проходит через фильтр нижних 
частот, | — выключен и сигнал идет в обход фильтра нижних частот. По 
умолчанию бит 5 равен 0. Бит 3 позволяет выбрать частоту для фильтра 
нижних частот, если бит 5 установлен в 0. Если бит 3 равен 0, будет вы- 
брана частота 3,2 кГц, если | — 8,8 кГц. По умолчанию бит 3 равен 0. 
Биты 2 и 1 позволяют выбрать входной источник: 0 или 2 — микрофон, 
1 — аудиодиск, 3 — линейный вход. 


С Регистр оЕБ имеет следующее назначение: бит 5 управляет состоянием 
выходного фильтра: 0 — включен и сигнал проходит через фильтр ниж- 
них частот, | — выключен и сигнал идет в обход фильтра нижних частот. 
По умолчанию бит 5 равен 0. Для стереорежима бит 5 следует установить 
в |. Бит 1 управляет стереорежимом для выходного канала: 0 — моно, 
1 — стерео. По умолчанию используется моно (0) режим. 


О Регистр 22ь управляет общим уровнем громкости для левого (биты 7—5) 
и правого (биты 3—1) каналов. Имеются 8 уровней (от 0 до 7) громкости, 
гле 0 соответствует значению -46 дБ, а 7 — 9 дБ с нелинейным шагом 
в 4 дБ. По умолчанию уровень равен 4 (-11 дБ). 


О Регистр 268 управляет уровнем громкости МПО для левого (биты 7—5) и 
правого (биты 3—1) каналов. Имеются 8 уровней (от 0 до 7) громкости, 
где 0 соответствует значению —46 дБ, а 7 — О дБ с нелинейным шагом 
в 4 дБ. По умолчанию уровень равен 4 (-11 дБ). 


О Регистр 28ь управляет уровнем громкости аудиодиска для левого (би- 
ты 7—5) и правого (биты 3—1) каналов. Имеются 8 уровней (от 0 до 7) 
громкости, где 0 соответствует значению —46 дБ, а 7 — 0 дБ с нелиней- 
ным шагом в 4 дБ. По умолчанию уровень равен 0 (-46 дБ). 


О Регистр 2Еь управляет уровнем громкости для левого (биты 7—5) и пра- 
вого (биты 3—1) линейных каналов. Имеются 8 уровней (от 0 до 7) гром- 
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кости, где 0 соответствует значению -46 дБ, а 7 — ОлБ с нелинейным 
шагом в 4 дБ. По умолчанию уровень равен 0 (-46 дБ). 


На этом можно завершить описание устройства микшера. 


6.2.3. Интерфейс МП! 


Звуковая плата обычно поддерживает два основных интерфейса МШГ: 
МРО-401 и $В-МЕЕ. 


В интерфейсе $В-МИШТ используются те же порты ввода-вывода, что и для 
процессора ОЗР. Передача данных может выполняться в двух режимах: 
нормальном и ЧАВТ (Чщшуегза| Азупсйгопоц$ Кесеуег/Ттапзпищег — универ- 
сальный асинхронный режим приема и передачи данных). В нормальном 
режиме сначала записывается команда МТУ, а после нее данные. В режиме 
ОАЕТ следует сразу послать ОЗР одну из команд разрешения работы с 
ОАВТ (34ъ, 356, з6в или 378). После того как О$Р будет переведен в режим 
ОАВТ, можно читать или писать МЕОЕ данные. После завершения работы 
следует послать ОЗР-команду сброса, чтобы восстановить нормальный ре- 
жим его работы. Для обнаружения МШГ-данных на входе используются два 
режима: поллинга и прерывания. В режиме поллинга при поступлении дан- 
ных на вход бит 7 в порту статуса (2хЕв) устанавливается в 1. Если данных 
нет, этот бит равен 0. Во втором режиме при поступлении данных происхо- 
дит прерывание. Для перехвата прерывания пишется специальная функция. 
В любом из этих режимов чтение данных происходит одинаково: 


1. Опрашивается порт 2хЕБ. 
2. Если бит 7 установлен в 1, считываются данные из порта 2хАв. 
3. Если бит 7 равен 0, переход к первому пункту. 


В интерфейсе МРО-401 (режим ЧАКТ) все ланные передаются без измене- 
ний между компьютером и МЕ устройством. Когла ОЗР установлен в ре- 
жим ОАВТ, он не реагирует ни на какие команды, кроме сброса (оон). Ин- 
терфейс МРО-401 в режиме ЧАКТ использует аппаратное прерывание и 
выделенные адреса ввода-вывода. Как правило, могут применяться следую- 
щие номера прерываний: 2, 5 (по умолчанию), 7 или 10. Для адресации ис- 
пользуются базовые порты 3008 или 3305 (по умолчанию). При этом порты 
ввода-вывода могут иметь следующие адреса: 300 и 301в или 3308 и 3311. 


Рассмотрим назначение портов подробнее. 


О Порт зх1ь в режиме чтения является портом состояния. С помощью дан- 
ного порта можно определить наличие данных в порту данных. Исполь- 
зуются только биты 7 и 6. Бит 7 отвечает за готовность к вводу данных: 
0 — данные доступны для считывания, | — нет данных для чтения. Бит 6 
отвечает за готовность данных на выходе: 0 — интерфейс готов к приему 
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данных или кода команды, | — интерфейс не готов принять данные или 
код команды. 


0 Порт зх1н в режиме записи служит для посылки кода управляющей 
команды. 


№ Порт Зхов — порт данных. Используется для считывания и записи данных. 


В листинге 6.20 показано, как следует проверять готовность интерфейса 
МШГ к приему данных. 


13М1Ч1 ргос пеаг 

поу ОХ, 3015 ; например, базовый регистр равен 3001 
@гераее: ; проверяем порт состояния 3011 
0 АБ, БХ ; читаем байт из порта 

фезе АГ, 402 ; если бит 6 равен 1 

317 ВхереаЕ ; повторяем опрос порта 

13М191 епар 

; пишем данные в порт 

са11 Т13М1491 ; проверяем, готов ли порт 

поу ОХ, 3011 ; порт команды 

поу АБ, ЮСта ; код команды 

сцЕ ОХ, АБ ; пишем команду в порт 

са11 13М191 ; проверяем, готов ли порт 

моу ОХ, 3008 ; порт данных 

оу АБ, ЮБаба; можно передавать данные 

оч ОХ, АБ ; пишем данные в порт 


Аналогичный пример на С++ показан в листинге 6.21. 


: ` Листинг 6. 21. Проверка г готовности и интерфейса мот в ‚С++ 





// пишем функцию проверки порта 
Боо1 ТзВеаамтрт () 
{ 


ОМОВР 9мВезо1 = 0; // переменная для хранения результата 
11Е 1Тиаема1е = 50000; 
уй11е ( -- 1ТиаеМа1е > 0) 


{ 
// читаем состояние порта 3018 
ЗпРоге ( 0х301, &ЧмВезо1е, 1); 
1Е ( ( амВеза1 & 0х40) == 0х00) гесакп 6хае; 
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// закончилось время ожидания 
1Е ( 1Тулема1е < 1) ргеак; 
} 
герагп Еа15е; 
} 
// используем нашу функцию для записи данных в порт 3008 
1Е ( ТзВеаамтрт) 
опЕРОгЕ ( 0х301, @СомтапЯ, 1); // записываем команду в порт 
1Е ( ТзВеаамтрт) 
соЕРогЕ ( 0х300, мрака, 1); // записываем данные в порт 


Разберем еще один пример, позволяющий определить наличие данных для 
считывания из порта МО] (листинг 6.22). 


1$5М141 ркос пеах 

поу ОХ, 3018 ; например, базовый регистр равен 3008 
@гераее: ; проверяем порт состояния 3018 
1п А, ох ; читаем байт из порта 

фезЕ АТ, 801 ; если бит 7 равен 1 

02 @гереае ; повторяем опрос порта 

Т5М:а1 епар 

; пишем данные в порт 

са11 13М191 ; проверяем, есть ли данные 
пох ОХ, 3008 ; порт данных 

11 АБ, ОХ ; читаем байт данных из порта 


Аналогичный пример для С++ показан в листинге 6.23. 


Листинг 5. 23. ‚Определение наличия | в в порту МТО! данных е в С++ 


// пишем функцию для проверки наличия данных в порту 
Роо1 Тзраеамтрт () 
{ 


ОИОВР 4иВезо1Е = 0; // переменная для хранения результата 
1пЕ 1Тулемазе = 50000; 
\р11е ( -- 1Тумема1® > 0) 


{ 
// читаем состояние порта 3018 
1пРоге ( 0х301, &АмвВезо1е, 1); 
1Е ( ( амВезо1е & 0х80) == 0х00) гебагп кое; 
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// закончилось время ожидания 
1Тииейа1е < 1) ргеак; 


Е ( 
} 


гебогп Еа15е; 


} 


// используем нашу функцию для чтения данных из порта 3008 


1Е ( Тзрафамтот} 
1пРоге ( 0х300, &амвеза1е, 1); // читаем данные 
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В режиме ЦЧАКТ поддерживаются только две команды: сброса и включения 
режима ЧАКТ. Команда сброса с кодом ЕЕь позволяет выполнить сброс ин- 
терфейса МРО-401. Если команда успешно выполнена, интерфейс возвра- 
тит значение ЕЕв через порт данных (33х05). Команда сброса может исполь- 
зоваться для проверки наличия интерфейса МРО-401. Например, чтобы 
выполнить сброс и убедиться в наличии интерфейса, можно применить код, 
показанный в листинге 6.24. 


Листинг 6.24. Проверка поддержки интерфейса МРИУ-401 


13М141 ргос пеаг 


поу ОХ, 3011 ; например, базовый регистр равен 3008 


@гераеф: 

1 АШ, ОХ 
{езЕ АБ, 408 
]27 @гереа® 
15М191 епар 


й 
й 
7 


й 


; основной код 


са1] Т$М1а1 
поу ОХ, 3018 
поу АГ, ОЕЕН 
ОЕ ОХ, АБ 
зоБ сх, сх 
11с ОХ 
@Мораха 

ш АБ, ОХ 
сезЕ АБ, 808 
ох @Роубог 
дес 2Х 

шт АБ, ОХ 
спр АБ, ОЕРЕВ 
34е Ех1еЕРГОос 
{1с ОХ 
@Роуфог: 

1оор @Морака 


й 
й 
й 


й 


проверяем порт состояния 3018 
читаем байт из порта 

если бит 6 равен 1 

повторяем опрос порта 


проверяем готовность МТОТ 

например, базовый регистр равен 3008 
команда сброса МРИ-401 

пишем в порт 


устанавливаем значение счетчика ожидания 


порт 3018 

проверяем наличие данных 
читаем состояние порта 

есть ли данные в порту 

данных нет 

порт 3008 

читаем порт данных 

успешное подтверждение команды 
выходим из процедуры 

порт состояния 3018 


делаем еще попытку 
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Аналогичный пример лля С++ представлен в листинге 6.25. 
Листинг 6.25. Проверка поддержки интерфейса МРИ-401 в С++ 
роо1 Т3МРИ 401 () 
{ 
11 1ТиеМма1е = 65535; 
// используем нашу функцию для проверки готовности МТРТ 
1Е ( ТзВеаамтот) 
оЦЕРогЕ ( 0х301, ОхЕЕ, 1); // записываем команду сброса в порт 
\1]е ( -- 1Таема1е > 0) 
{ 
// проверяем наличие данных 
1Е ( Тзрабамтрт) 
1ПРогЕ ( 0х300, &амВезо1&, 1); // читаем данные 
1Е ( амВезо1Е == 0хЕР) гебакп 6гие; 
// закончилось время ожидания 
1Е ( 1Т4мема1е < 1) ЬБгеак; 


} 
гебагп Еа1зе; // МРО-401 отсутствует 


Вторая команда (зЕъ) позволяет включить режим ЦАКТ для обмена ланны- 
ми. Если команда успешно выполнена, интерфейс возвратит значение ЕЕь 
через порт данных (3хоь). Принцип работы с ней такой же, как и с коман- 
дой сброса. 


Для передачи данных в режиме ЦАКТ на внешнее устройство МПТ нужно 
сделать слелующее: 


1. Проверить готовность устройства МГПУ. 
2. Если бит 6 равен 0, следует записать данные в порт зхоь. 
3. Если бит 6 равен |, необходимо перейти к первому пункту. 


Для получения данных от внешнего устройства МТОТ необходимо выпол- 
нить следующие действия: 


1. Проверить наличие данных в порту статуса. 
2. Если бит 7 равен 0, следует прочитать данные из порта зхоь. 
3. Если бит 7 равен 1, необходимо перейти к первому пункту. 


На этом я хотел бы завершить описание работы с составляющими звуковой 
платы и привести наиболее часто встречающееся расположение базовых ад- 
ресов (табл. 6.6) и регистров (табл. 6.7). 
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Смещение адреса 
регистра от базового 


ов 
оп 
18 
2. 
2 
ЗВ 
48 
5 
вп 


108 


118 
128 
13. 
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Таблица 6.6. Базовые адреса звуковых плат 


Базовый адрес 


2201 
2401 
2601 
2801. 


3885 для РЕМ 


Описание 


Диапазон адресов 
2205-2335 
2405-2535 
2608-273в 
2808-2935 


389. для РЕМ 


Таблица 6.7. Адреса регистров звуковых плат 


Регистр состояния ЕМ (чтение) 


Адресный регистр ЕМ (запись) 


Регистр данных ЕМ (только запись) 


Расширенный регистр состояния ЕМ (чтение) 


Расширенный адресный регистр ЕМ (запись) 


Расширенный регистр данных ЕМ (только запись) 


Адресный регистр микшера (только запись) 


Регистр данных микшера (чтение и запись) 


Регистр сброса О$Р (только запись) 


Регистр состояния ЕМ (чтение) 


Адресный регистр ЕМ (запись) 


Регистр данных ЕМ (только запись) 


Регистр ОЗР для чтения данных (только чтение) 


Регистр ОЗР для записи команд и данных (запись) 


Регистр состояния буфера записи (бит 7) ОЗР (чтение) 


Регистр состояния буфера чтения (бит 7) ОЗР 
(только чтение) 


Регистр команд или данных для СО-ВОМ 
(чтение и запись) 


Регистр состояния для СО-ВОМ (только чтение) 


Регистр сброса для СО-ВОМ (только запись) 


Регистр включения СО-ВОМ (только запись) 
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6.3. Использование \//т32 АР1 


УМтао\м5 предоставляет программисту возможность работы с микшером зву- 
ковой платы и с интерфейсом МОЕ Использование МТОГ больше относит- 
ся к программированию звука, поэтому мы его рассмотрим в следующей 
главе, а вот управление микшером изучим прямо здесь, поскольку это имеет 
непосредственное отношение к программированию звуковой платы. 


В Уп4о\$ достаточно удобно работать с микшером, поскольку имеется 
универсальный программный набор соответствующих функций. Нам не 
нужно разбираться в портах и особенностях той или иной звуковой платы, 
а достаточно использовать стандартные функции \!132. Рассмотрим эти 
функции подробнее: 


С п:хегсбеереуСарз. Позволяет получить информацию 06 установленном 
микшере; 


С п1хехорер. Позволяет открыть указанное устройство микшера; 
О пахехс1озе. Закрывает указанное устройство микшера; 


С пахегбеето. Позволяет получить идентификатор для указанного устройст- 
ва микшера; 


С т+хегбеЕмаюреуз. Определяет количество микшеров, установленных в сис- 
теме (аппаратных и виртуальных); 


С тхегбеетАпе1ТрЕо. Позволяет получить информацию. об указанной линии 
(канале) микшера; 





С п:хегбеетатеСолего1з. Позволяет получить различные элементы управле- 
ния (например, ползунки для отображения уровней громкости), распо- 
ложенные на указанной линии (аудиоканале) микшера; 


С тахегбеЕСопего10ека11з. Позволяет получить значения параметров для 
элементов управления, расположенных на указанной линии (аудиокана- 
ле) микшера; 


С т:хегбеЕСопехко10ека115. Позволяет установить новые значения парамет- 
ров для элементов управления, расположенных на указанной линии 
(аудиоканале) микшера. 


Для того чтобы разобраться, как все это работает, я приведу пример класса 
для управления микшером. Назовем наш класс тривиально — см1хег. В лис- 
тинге 6.26 приведен файл СМ хег.П. Перед началом работы следует добавить 
в опции компоновщика ссылку на стандартную библиотеку \УМиати. 5. 
Кроме того, в начало файла поместите ссылку на файл ММзумет.В. 


Листинг 6.26. Файл СМихег.В класса СМ1хех 
// подключаем файл поддержки функций микшера 
#10с10ае <пизузвем.в> 


Глава 6. Звуковая карта 263 


// максимальное количество микшеров 
еЕпе МАХ МТХЕВ 10 
// объявляем наш класс 
с1азз СМахех 
{ 
ри] 1с: 
СМ1хег (); 
у1гЕиа1 -СМ1хег (); 
// поиск первого микшера 
ус1а Тп1ЕМахегк (); 
// функция для установки дескриптора родительского окна 
у01а зеенимр ( НИМр 6019); 
// функция для получения идентификатора злемента управления 
ОМОВО Сеесеу1Тр ( 106 1№м); 
// получение идентификатора открытого микшера 
НМТХЕВ Сеем1АхехтТр (); 
// основные функции работы с микшером 
// управление общим каналом звука 


РИОКР СееМ1пМазеехУо1 (); // получить минимальный уровень громкости 
РИОВР СееМахМазеех\о1 (); // получить максимальный уровень громкости 
РИОВР СееТ1сМазкехгУо1 (); // получить значение шага изменения уровня 
ПИОВКО СекМазкегУа1ие (); // получить текущее значение громкости 


у01А 5еЕМазкегхУа1ае (ОМОВР амУа1ае); // установить новое значение 

// управление общим отключением звука 

Боо1 СеЕМазеехкМиее (); // проверить состояние 

у01Я ЗеМазхетМаее ( РМОВО амУа1ае); // установить новое состояние 
// управление фильтром нижних частот (если он есть на звуковой плате) 


ОМОВО СеЕМ1пВаз$ (); // получить минимальное значение 
ОМОВО СесМахВазз (); // получить максимальное значение 
ОМОВО Сек$$ерВазз (); // получить значение шага изменения уровня 


ОМОВР СееваззУа1ае (); // получить текущее значение 
у014 Зе ВаззУа1ае ( ПМОВО Чм\Уа1оае); // установить новое значение 
// управление фильтром верхних частот (если он есть на плате) 


РИОВО Сеем1пТгеб1е (); // получить минимальное значение 

ОИОВР СеЕМахТгер]1е (); // получить максимальное значение 

ОМОВР СеебеерТгер1е (); // получить значение шага изменения уровня 
ОМОВР СееТтТгер1еУа1ие (); // получить текущее значение 


уо1А ЗесТгер1еУа1це ( ОМОВР амУа1ае); // установить новое значение 
ре1хафе: 
НИМО г 0019; // переменная для хранения дескриптора окна 
НМТХЕВ М1хехг; // дескриптор микшера 
// структуры данных для поддержки микшера 
МТХЕВТЛМЕ тх1; 
МТХЕВСОМТВОЬ шхс; 
МТХЕВЬТМЕСОМТВОТ$ шх1с; 
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// пишем свою структуру для хранения информации о микшере 

фуреаеЕ зегасЕ _М1хекТтРо 

{ 

сраг Маме [МАХРМАМЕЬЕМ]; // строковое название микшера 

упз1апеЯ 116 чТО; // идентификатор устройства микшера 

МОВР мап!Т0; // идентификатор производителя микшера 

МОВО рхгоаТО; // идентификатор изделия 

ОМОВО акуУег; // номер версии драйвера 

ОМОВО 9мЁР1аачз; // дополнительные возможности микшера 

РИОВЬ ам1пез; // количество доступных линий микшера 

} МТХЕВТМРО, *РМТХЕВТМЕО; 

// структура описания значений параметров для компонентов микшера 

суреаеЁ зегасЕ _Ракатз 

{ 

сВак паме[50]; // имя компонента 

ОМОВР ЧмТО; // идентификатор компонента 

ОМОВО ш1п; // минимальное значение 

РИОВО шах; // максимальное значение 

РИОВР сиг; // текущее значение 

ОМОВО 5%Еер; // шаг 

} СОМРОМЕМТРАВАМ, *РСОМРОМЕМТРАВАМ; 

// дополнительная структура для описания используемых компонентов 

СуредеЕ зегисЕ _Сотропепез 

{ 
// 0- МазЕег Уоие, 1- Мабе Мазфег, 2- Вазз, 3- Тге Ле 
СОМРОМЕМТРАВАМ сощРр [4]; 

} СОМР; 

// объявляем необходимые структуры 

СОМР сом; 

МТХЕВТМЕО 1пЕо; 

// и функции 

НМТХЕВ ОрепМ1хег ( НИМЬ Випа, ОТМТ пахегТО); // открыть микшер 

Уо1Я С1озеМ1хег (); // закрыть микшер 

}; // конец объявления класса Силхег 


А теперь посмотрите на файл реализации (СМ хег.срр) класса см1хех, пред- 
ставленный в листинге 6.27. 


{1пс1аае "зЕдаЁх.В" 
#1пс]аае "СМ1хехг.В" 
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// конструктор класса 
СМ1хег :: СМахег () 
{ 
М1хек = МОБ; 
п 0014 = М; 
// готовим структуры к использованию 
пешзеЕ ( &сом, 0, 512еоЕЁ ( СОМР)); 
петзее ( &шхс, 0, 312еоЕЁ ( МТХЕВСОМТВОТ,) ); 
( &1х1, 0, $12еоЕЁ ( МТХЕВЬЫТМЕ)); 
пепзее ( &мх1с, 0, з12еоЕЁ ( МТХЕВЬТМЕСОМТВОГ5)); 
( а1пЕо, 0, 312еоЕЁ ( МТХЕВТМЕГО)); 
// если микшер в системе не обнаружен, выходим 


пепзее 
пейзее 


ЗЕ ( п1хегбебм№оюреуз ()) гебагп; 
} 
// деструктор класса 
СМ1хег :: -СМ1хег () 
{ 
// закрываем устройство микшера 
С1озем1хег (); 
} 
// функция для установки дескриптора родительского окна 
%01А ЗеенНиМо ( НИМО №519); 
{ 
м 2014 = 1519 
} 
// функция поиска и инициализации микшера 
у01а СМ1хег :: Тп1М1хек () 
{ 
1Е (м 8019 == МЫ.) гебогп; 
// ищем первый завалявшийся микшер 
Еог (11 1 = 0; 1 < МАХ МТХЕВ; 1++) 
{ 
1Е ( 'ОрепМ1хек ( м №519, 1)) 
сопЕ1те; 
е1зе 
Бгеак; 
ЗЕ (1> 9) кебаги; 
} 
// получаем информацию об общем регуляторе громкости 
пх1.СО5егисЕ = 512еоЕЁ ( МТХЕВШТМЕ); 
пх] .ЧмСотропепеТуре = МТХЕВЬТМЕ _СОМРОМЕМТТУРЕ _Р5Т_ЗРЕАКЕВ$; 
к1хегбееТ1пеТрЁо ( ( НМТХЕВОВУ) М1хег, &тх1, МТХЕК_ОВУЕСТЕ НМТХЕВ | 
МТХЕВ_СЕТЬТМЕТМЕОЕ СОМРОМЕМТТУРЕ); 
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// получаем параметры для общего регулятора громкости 
пх1с.со5ЕгасЕ = з4хеоЕЁ ( МТХЕВЬТМЕСОМТВОГ 5) ; 
пх1с.Ам1петТр = шх1.ам петр; 

тх1с.ЧмСопего1Туре = МТХЕВСОМТВОГ СОМТВОГТУРЕ УОГОМЕ; 
шх1с.сСопЕхо|$ = 1; 
х1с.сбихсег1 = $12ео0Е ( МТХЕВСОМТВОГ,) ; 
их1с.рашхсег1 = &пхс; 
пухегсе1пеСопехо1$ ( ( НМТХЕВОВУЛ) М1хехк, &х1с, МТХЕВ_ОВОЕСТЕ НМТХЕВ 
МТХЕВ СЕТЬТМЕСОМТВОЬЗЕ ОМЕВУТУРЕ); 

// сохраняем полученные значения в нашу структуру 





$Егсру ( сом.сомР[0].паше, пх1.32Маме); // имя регулятора громкости 
сом. сомР [0] .мап = шхс.Вочпа$ . ЯМА плим; // минимальное значение 

0] .мах = шхс.Воипаз .ЯмМах ит; // максимальное значение 
0 


[ 
сом. сомР [ 
Сом . СОПР [ 


].ЧмтТр = шхс.9иСопехо1ТО; // уникальный идентификатор 
сом.сомРр[0].5$ер = шхс.Меех1с$.с5%ерз; // шаг 

// получаем информацию о переключателе, управляющего общим звуком 
пемзефе ( &шхс, 0, $12еоЕЁ ( МТХЕВСОМТВОТ) }; 

петзее ( &пх1, 0, з12еоЕ ( МТХЕВЬТМЕ)); 

метзее ( &пх1с, 0, з12еоЕ ( МТХЕВЬТМЕСОМТВОГ $) ); 

пх1.ср56кисЕ = з12еоЁ ( МТХЕВЬТМЕ); 

шх1.ОмСотропепеТуре = МТХЕВЬЫТМЕ_СОМРОМЕМТТУРЕ О5Т_ЗРЕАКЕВ$; 


т1хегсее1пеТтЕо ( ( НМТХЕВОВО) Махег, &пх1, МТХЕВ ОВУЕСТЕ НМТХЕВ | 
МТХЕВ_СЕТЬТМЕТМЕОЕ СОМРОМЕМТТУРЕ); 

// получаем параметры для управления переключателем 

их]с.со5екисЕ = захеоЕ ( МТХЕВЬТМЕСОМТВОГ $} ; 

шх1с.ЧмЬфпетр = пх1.амЬалетр; 

шх1с.ЭмСопеко1Туре = МТХЕВСОМТВОГ СОМТВОГТУРЕ МОТЕ; 

пх1с.сСопеко1$ = 1; 

пх1с.сбмхсетг1 = з42еоЕ ( МТХЕВСОМТВОТ,) ; 

пх1с.рашхсех1 = &хс; 

ш1хегбее1пеСопеко1$ ( ( НМТХЕВОВУ) М1хег, &мх1с, МТХЕВ ОВУЕСТЕ НМТХЕВ 

МТХЕВ_СЕТЬТМЕСОМТВОГ$ Е _ОМЕВУТУРЕ); 

// сохраняем полученные значения в нашу структуру 

зЕгсру ( сом.сомР [1] .паме, пх1.з;Матме); // имя переключателя 

сом.сошр[1].@мТР = пхс.а9м\Сопего1ТР; // идентификатор переключателя 

// получаем информацию о регуляторе нижних частот 

шетзее ( бюхс, 0, $з12еоЕЁ ( МТХЕВСОМТВОЬ) ); 

петзефе ( &пх1, 0, захеоЕ ( МТХЕВЬТМЕ)); 

метзеф ( &тх1с, 0, $з12еоЕ ( МТХЕВЫТМЕСОМТВОГ 5) }; 

пх1.ср5екисЕ = з1теоЕЁ ( МТХЕВЫТМЕ); 

пх1.ОмСотропепеТуре = МТХЕВЬТМЕ_СОМРОМЕМТТУРЕ_О5Т_ЗРЕАКЕВ5; 

ш1хегсее1пеТтЕо ( ( НМТХЕВОВУ) Махег, &мх1, МТХЕВ ОВОЕСТЕ НМТХЕК | 
МТХЕВ_СЕТЬТМЕТМЕОЕ _СОМРОМЕМТТУРЕ) ; 
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// получаем параметры для регулятора нижних частот 

их1с.сЬ5Екгасе = $12еоЕЁ ( МТХЕВЬТМЕСОМТВОГ $) ; 

шх1с.ЧмЬ1петТР = шх1.ди1Зпето; 

пх1с.ЧмСопего1Туре = МТХЕВСОМТВОГ СОМТВОГТУРЕ_ВА$5; 

пх1с.сСопЕго1$ = 1; 

шх1с.сбмхсех1 = $з12еоЕЁ ( МТХЕВСОМТКВО Г); 

пх1с.рашхсек1 = &щхс; 

пухехбее1 1 пеСопехо1$ ( ( НМТХЕВОВУ) М1хек, &тх1с, МТХЕК ОВОЕСТЕ НМТХЕК | 
МТХЕВ_СЕТЬТМЕСОМТВОЬ$Е ОМЕВУТУРЕ); 

// сохраняем полученные значения в нашу структуру 

ЗЕхсру (сом.сопР[2].паше, пх1.$=Мате); // имя регулятора нижних частот 

сом. сомР [2] .пап = шхс.Воипа$ . ЧмМплмам; // минимальное значение 

сом. сощР [2] пах = шхс.Воип4$ .ОмМах]иит; // максимальное значение 

сом. сор [2] .ЧмТр = шхс.ЧмСопЕго1ТР; // уникальный идентификатор 

сом. сотр [2] .53&ер = шхс.Мефк1сз.с5Еерз; // шаг 

// получаем информацию о регуляторе верхних частот 

пемзее ( &тхс, 0, з1хеоЕ ( МТХЕВСОМТВОВ) ); 

пешзее ( &мх1, 0, злхеоЕ ( МТХЕВЬЫТМЕ) ); 

петзес ( &мх1с, 0, з12еоЕ ( МТХЕВЬТМЕСОМТВОТ 5) ); 

пх1.ср5ЕкиасЕ = $12еоЕ ( МТХЕВЫТМЕ); 

пх1.ЧмСотропепсТуре = МТХЕВЬТМЕ СОМРОМЕМТТУРЕ_О$Т_ЗРЕАКЕВ$; 

пахехсесЬапеТтЕо ( ( НМТХЕВОВУ) М1хех, &пх1, МТХЕВ ОВФЕСТЕ НМТХЕВ | 

МТХЕК_СЕТЬТМЕТМЕОЕ СОМРОМЕМТТУРЕ); 

// получаем параметры для регулятора верхних частот 

пх1с.со5екасЕ = $12еоЕЁ ( МТХЕВГТМЕСОМТВОГ 5$) ; 

пх1с.ЧАмапетр = пх1.АмЬапетр; 

их1с.ЯиСопехо1Туре = МТХЕКСОМТКОГ СОМТВОГТУРЕ ТВЕВТЕ; 

пх1с.сСопехко1$ = 1; 

их1с.сюмхсек1 = $12еоЕ ( МТХЕВСОМТВОГ) ; 

шх1с.рамхсег1 &тхс; 

пихехбееЬ1пеСопехго1$ ( ( НМТХЕВОВУ) М1хех, &х1с, МТХЕВ_ОВОЕСТЕ_НМТХЕВ | 
МТХЕВ СЕТЬТМЕСОМТВОГ5Е ОМЕВУТУРЕ); 

// сохраняем полученные значения в нашу структуру 





зЕхсру (сом.сомР [3] .паме, пх1.з2Маме); // имя регулятора верхних частот 
сом. сомР [3] пап = шхс.Воипа$ .А\Млпимим; // минимальное значение 

сом. сотр [3] мах = мхс.ВойпЯ$ .ЯмМах] щит; // максимальное значение 

сот. сор [3] .ОмТр 
сот. сопР [3].536ер = шхс.Мефх1с$.с5%ерз; // шаг 
} // конец функции инициализации 

// функция для закрытия микшера 


шхс .ЧмСопехо1Т0; // уникальный идентификатор 


у01А СМ1хег :: С1озеМахехг () 


{ 


1Е ( Мхех) 
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// если микшер существует, закрываем его 
пахегС1о5е ( М1хег); 
М1хех = №; 
} 
} 
// функция для получения идентификатора текущего микшера 
НМТХЕВ СМ1хег :: бебМхегтр ({) 
{ 
1Е ( М1хег == МОБ) 
тесагп 0; 
хебахп М1хег; 
} 
// функция для получения идентификатора для указанного компонента 
БИОВКО СМ1хех :: СееСех1ТрЬ ( ап 1М№Мом) 
{ 
1Е ( Махег == МОЪТ) 
тебагп 0; 
зилЕСВ ( 1Мам) 
{ 
сазе 0: // Мазфек Уо1лаще 
тебаги сом. сомР [0] .9мТО; 
сазе 1: // Мазеег Мабе 
тебагтп сом.сомР [1] .9мТО; 
сазе 2: // Ва55 
тебагп сом. сотр [2].9мТО; 
сазе 3: // Ткхее 
тебаги сом.сомР [3] .АмТО; 
} 
тебагп 0; 
} 
// функция для открытия устройства микшера 
НМТХЕВ СМ1хег :: ОрепМ1хег ( НММО Бута, ОТМТ пахекП)} 
{ 
ОТМТ аТО = 0; 
НМТХЕВ п1хетТМР; 
МТХЕВСАР$ п1хегСарз; 
// получаем информацию для указанного микшера 
1Е ( пахегбеереуСарз ( пахекТО, &п1хегСарз, 51теоЕ ( МТХЕВСАР$) )}) 
{ 
хесакп ( М1хег); // возвращаем идентификатор предыдущего микшера 
} 
// открываем новое устройство микшера 
1Е ( ахегОреп ( &пахетТМР, п1хегтТР, (РМОВО) Вита, о, 
САШВАСК_ИТМООЙ) ) 
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// если не удалось открыть новый микшер, возвращаем предыдущий 
гебахп ( Махег); 
) 
// если предыдущий микшер был открыт, закрываем его 
1Е ( Мхег) 
{ 
1Е ( пхехС1озе ( М1хех)) 
{ 
// если не удалось закрыть текущий микшер, закрываем новый 
п1хехС1озе ( пахехТМР); 
хебагп ( М1хег); 


} 
// получаем информацию о микшере 
пахегсееТР ( ( НМТХЕВОВУ) М1хех, &аТр, МТХЕК_ОВОЕСТЕ_НМТХЕВ); 
зЕхсру ( 1пЕо.Маме, пахехСар$.$2Рраме); 
1рЕо.аТр = «Ш; 
1пЕо.мапТР = п1хегСар$ .иМ1а; 
1пЕо.ргойТр = пахегСарз.мчР1А; 
1о0Ео.АкуУег = п1хегСарз.уОг1уехУегз$1оп; 
17Ео.ЧмЕР1ад$ = п4хегСарз. Ем аррогЕ; 
1пЕо.Чм1Зрез = п1хегСарз. срез 1па&1оп$; 
// сохраняем идентификатор открытого микшера 
М1хег = пахехТМР; 
// выходим из функции 
хебахп ( пахетгТМР); 
} 
// получаем текущее значение для общей громкости 
ОМОВО СМ1хех :: СеЕМазфетУа1]е () 
( 
МТХЕВСОМТВОГОЕТАТТ,$ ОМ5ТСМЕР шхсаУуо ле; 
МТХЕВСОМТВОГОЕТАТТЬ$ шхса; 
// получаем текущее значение 
ихса.сЬ5ЕкгасЕ = з1хеоЕ ( МТХЕВСОМТВОЬОЕТАТТ$) ; 
шхса. ЧиСопЕго]1ТР = сош.сомР [0]. 9мТО; 
шхса. сСВаппе1$ = 1; 
шхса. сМо11р1еТкемз = 0; 
шхса. сЬреба11$ = $12еоЕ ( МТХЕВСОМТВОГОЕТАТЬ$ ОМ$УТСМЕО); 
пхсЧ.рареба11$ = &тхсаУо1още; 
пухехсееСопего10ефа11$ ( ( НМТХЕКОВУ) М1хех, &пхса, 
МТХЕВ_ОВОЕСТЕ_НМТХЕВ | МТХЕВ_СЕТСОМТКОГОЕТАТЬЗ Е УАБОЕ); 
сот. сомР [0] .сах = шхсаУо1лате .@мУа1е; 
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// возвращаем текущее значение 
хеёагп шхсаУо1ате. ЧмУа14е; 
} 
// функция для установки текущего значения общей громкости 
7014 СМ1хех :: беЕМазкех\Уа1ие ( РМОВР диУа1ое) 
{ 
МТХЕКСОМТВОТРЕТАТТ$ ОМЗТСМЕР шхсаУо1иаме = { амУа1ле }; 
МТХЕВСОМТВОТОЕТАТТ5 шхса; 
// устанавливаем новое значение 
пхса.сю5екиасЕ = з12еоЕЁ ( МТХЕВСОМТВОГОЕТАТТ 5) ; 
шхса .ЧмСопЕго1ТР = сошм.сошР [0] .9мТО; 
шхса. сСваппе1$ = 1; 
пхса. сМи1Е1р1еТ%етз = 0; 
шхса.сБета11$ = $1теоЕ ( МТХЕВКСОМТКОГОЕТАТТ$ ОМ5ТСМЕР); 
шхса .рарефа11$ = &мхсаУо1оте; 
па хегбееСопего1ефа11$ ( ( НМТХЕВОВУ) Махек, &пхса, 
МТХЕК ОВОЕСТЕ_НМТХЕВ | МТХЕВ_ЗЕТСОМТВОЬОЕТАТЬЗЕ УАГОЕ) ; 
} 
// получение минимального значения регулятора общей громкости 
РИОВР СМ1хег :: Сеем1пМазеехУо1 () 
{ 
ТЕ ( Махег == МО) 
хебахп -1; 
гебахп сом. сошР [0] пп; 
} 
// получение максимального значения регулятора общей громкости 
РИОВР СМ1хег :: СеМахМазвет\о1 () 
( 
1Е ( Мхек == МО) 
гтебакп -1; 
гебакп сом.сомР [0] .тах; 
} 
// получить шаг изменения общей громкости 
ОМОВР СМ1хег :: СеебеерМазеекУо1 () 
{ 
1Е ( Махехг == №1) 
гебакп -1; 
хебохр сом. сотшР [0] .5%ер; 
} 
// получение текущего состояния переключателя звука 
Боо1 СМ1хех :: СбеЕМазфетМаке () 
{ 
МТХЕВСОМТВОЬОЕТАТТ,$ _ВООТЕАМ ихсаМаее; 
МТХЕВСОМТВОЬОЕТАТТ5$ тшхса; 
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// получаем текущее значение 
шхса.со$ЕгасЕ = $з12еоЕ ( МТХЕВСОМТВОГОЕТАТТ. 5); 
шхса. ЧмСопЕко1ТР = сом. сотр [1] .@мТО; 
шхса. сСВаппе1$ = 1; 
пхса. сМо11р1еТ%етз = 0; 
шхса. срОееа11$ = з12еоЁ ( МТХЕВСОМТВОБРЕТАТТ$ ВООЬЕАМ); 
шхсЧ.ра)ефа11$ = бахсаМиее; 
пи хехбсееСопего1Оефа11$ ( ( НМТХЕВОВУ) М1хег, &шхса, 
МТХЕВ_ОВЗЕСТЕ НМТХЕВ | МТХЕВ СЕТСОМТВОГОЕТАТЬЗЕ УАГОЕ); 
сом. сомР [1] .саг = шхсаМоее. ЕУа1ае; 
// возвращаем текущее значение 
гебахп ( Роо1) шхсаМике. ЕУа1ае; 
} 
// установка состояния переключателя звука 
Уо1А СМ1хег :: ЗеЕМазбехкМосе ( ОМОВКО амуа1ае) 
{ 
МТХЕВСОМТВОГОЕТАТТ 5 ВООТЕАМ шхсЧМофе = { аУа1ще }; 
МТХЕВСОМТВКОГОЕТАТТ, 5$ щхса; 
// устанавливаем новое значение 
ихса.ср56гисЕ = $з12еоЕ ( МТХЕВСОМТВКОГОЕТАТТ 5) ; 
ха. ЯмСопего1ТР = сом. сомРр [1] .Ч “ТО; 
пхса.сСВарпе]1$ = 1; 
шхса . СМо1Е1р1етемз = 0; 
шхса.сррефа11$ = $1хеоЕЁ ( МТХЕВСОМТВОГОЕТАТТ$ ВООГЕАМ); 
пхсЯ.рарефа11$ = &мхсаМаее; 
пухегЗееСопего10ефа11$ ( ( НМТХЕВОВУ) М1хехг, бихса, 
МТХЕВ ОВОЕСТЕ НМТХЕВ | МТХЕК ЗЕТСОМТВОГОЕТАТЬ$Е УАГОЕ); 
} 
// получение текущего значения для регулятора нижних частот 
РиОВр СМахег :: СееВаззУа1ще () 
{ 
МТХЕВКСОМТВОГОЕТАТЬ$ ОМ5ТСМЕО мхсаУа14е; 
МТХЕВКСОМТКОБОЕТАТТ, $ шхса; 
// получаем текущее значение 
шхса.со5$6гасЕ = з1теоЕЁ ( МТХЕВСОМТВОГОЕТАТТ 5); 
мхса .ЧмСопехо1ТО = сом.сомР [2] .9мТО; 
пхса. сСваппе1$ = 1; 
шхса. сМо11р1еТ%етз = 0; 
шхса.сррера11$ = $з1теоЕЁ ( МТХЕВСОМТВОГОЕТАТТ$ ОМЗТСМЕО); 
пхса.раПефа11$ = &тхсЯУа1ае; 
п1хехбеЕСоп®го10ефа11$ ( ( НМТХЕВОВО) М1хег, &мхса, 
МТХЕК ОВОЕСТЕ НМТХЕВ | МТХЕВ_СЕТСОМТВОГРЕТАТЬЗЕ УАГОЕ) ; 
сом. сор [2] сиг = шхсЯУа1ае. ди\Уа1ае; 
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// возвращаем текущее значение 
хеагп шхсаУа1ае .ОиУа1ае; 
} 
// установка нового значения для регулятора нижних частот 
у014 СМ1хег :: ЗеЕВаззУа]ае ( ПМОВО амУа1ае) 
{ 
МТХЕВСОМТВОГОЕТАТТ$ ОМ$ТСМЕО шхсЯ\Уо1 = { амуаше }; 
МТХЕВСОМТВОГОЕТАТТ$ пшхса; 
// устанавливаем новое значение 
пхса. сЬ5егасе = $12еоЕ ( МТХЕВСОМТВОГРЕТАТТ 5) ; 
хса. ЭмСопего1Т0 = сом.сотР [2] .9мТО; 
пхса.сСВаппе]1$ = 1; 
щхса. сМи1 Е 1р1еТеемз = 0; 
шхса. сЬ0ефа11$ = $1теоЁ ( МТХЕВСОМТВОЬОЕТАТТ.$ ОМ$ТСМЕО) ; 
пхса.рарефа11$ = &тхсаУо1; 
пу хегбееСопетго1Бе®а11$ ( { НМТХЕВОВУ) М1хег, &хса, 
МТХЕК_ОВФЕСТЕ НМТХЕВ | МТХЕВ_ЗЕТСОМТВОЬОЕТАТЬЗЕ УАШОЕ); 
} 
// получение минимального значения регулятора нижних частот 
ОМОВО СМ1хег :: СебМ1пВаз$ () 
{ 
1Е ( Махег == МОШ) 
хебатп -1; 
тебаги сом.сотР [2] .пап; 
} 
// получение максимального значения регулятора нижних частот 
ОМОВО СМ1хег :: СебМахВаз$$ (} 
{ 
1Е ( М1хек == М№ОЪЬ} 
тебагп -1; 
тебагп сом.сомР [2] .тах; 
} 
// получить шаг изменения для регулятора нижних частот 
РМОВО СМ1хег :: Сес5ерВа$$ () 
{ 
1Е ( М1хег == М9) 
тхевагп -1; 
тесагп сом. сомР [2] .5%ер; 
} 
// получение текущего значения для регулятора верхних частот 
ОИОВО СМ1хег :: СесТгер1еУа]1ае () 
{ 
МТХЕВСОМТВОЬОЕТАТЬ$ ОМЗТСМЕО шхсаУа1ае; 
МТХЕВСОМТКОГОЕТАТЬ$ шхса; 
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// получаем текущее значение 
ихса. сЬбегас® = з1геоЕЁ ( МТХЕВСОМТВОГОЕТАТТ 5) ; 
шхса .ЧмСопего1ТО = сом.сотР [3] .ЧмТО; 
пхса.сСВаппе1$ = 1; 
ихса. сСМа11р1еТ%ет$ = 0; 
шхса.сЬРеса11$ = $12еоЁ ( МТХЕКСОМТВОЬОЕТАТ1.5 ОМЗТСМЕО); 
пхса.рарефа11$ = ёмхсаУа1ае; 
птхехСееСопего1ека11$ ( ( НМТХЕВОВУ) Махег, &ихса, 
МТХЕВ_ОВОЕСТЕ НМТХЕВ | МТХЕК СЕТСОМТВОГОЕТАТЬЗЕ УАТОЕ) ; 
сом.сомР [3] .саг = шхсаУа1ае. Чи\/а1е; 
// возвращаем текущее значение 
тееахп пхсаУа1е.мУа11е; 
} 
// установка нового значения для регулятора верхних частот 
%01а СМ1хег :: ЗеёТкер1еУа1ие ( ПМОВО амУа1ае) 
{ 
МТХЕВСОМТВОЬОЕТАТТ$ ОМ$ТСМЕР шхсаУо]1 = { дмУа1ае }; 
МТХЕВСОМТВОЬОЕТАТТЬ$ шхса; 
// устанавливаем новое значение 
ихса. сЬЗегасе = $12ео0оЁ ( МТХЕВСОМТВОЬБОЕТАТТ5) ; 
тахса. ЧиСопего11ТР = сот. сощР [3] .9мТО; 
пхса. сСВаппе]1$ = 1; 
шхса. сМо11р1еТеемз = 0; 
шхса. сЬ)ера11$ = $12еоЁ ( МТХЕВСОМТВОЬОЕТАТТ$ ОМ$ТСМЕР); 
пхса.рарефа11$ = &мхса\о1; 
похегбе(Сопего10е®а11$ ( ( НМТХЕВОВУ) М1хег, &пхса, 
МТХЕВ_ОВОЕСТЕ_НМТХЕВ | МТХЕВ_ЗЕТСОМТВОЬБОЕТАТЬЗЕ УАБОЕ); 
} 
// получение минимального значения регулятора верхних частот 
ВМОВКО СМ1хех :: СеЕМапМазкекУо1 () 
{ 
1Е { Мхег == МЫ) 
теЕиагп -1; 
хебакп сом.сотР[0].пап; 
} 
// получение максимального значения регулятора верхних частот 
ОИОВР СМ1хех :: СеЕМахМазфехк\о1 () 
{ 
1Е ( М1хек == №0) 
тебагп -1; 
хесагп сом. сошР [0] .пах; 
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// получить шаг изменения для регулятора верхних частот 
РИОКР СМ1хех :: СеЕ5керМазеекУо1 () 
{ 

1Е ( М]хек == МОБЬ) 

хебиагп -1; 

хебагп сом.сомР [0] .5%ер; 


Теперь, когда наш класс управления микшером готов, можно добавить его в 
свою программу. Как вы заметили, мы обработали только четыре управ- 
ляющих компонента микшера: регулятор общей громкости, переключатель 
для отключения и включения звука, а также регуляторы низких и высоких 
частот. Регулировка частот поддерживается не всеми звуковыми платами. 
Данный класс прекрасно будет работать с семейством звуковых плат от 
Стеапуе ЗВ Шуе!. На платах других производителей лолжна быть поддержка 
управления низкими и высокими частотами. 


Кроме того, разобравшись с работой класса, читатель сможет самостоятель- 
но добавить обработку других стандартных компонентов микшера: регули- 
ровка громкости МОТ, аудиодиска, линейного канала. Дополнительную 
информацию можно получить из документации фирмы Мегозой (на сайте 
ууу. 15д1.сот) по программированию звука в \/и140\%5$, поскольку описать в 
небольшой главе все возможности просто нереально. Главное — чтобы вы 
поняли принципы работы с микшером, и тогда сможете самостоятельно ра- 
зобраться с остальными возможностями. 


В завершении темы я приведу примерный код, использующий наш класс 
СМхег (листинг 6.28). Создайте в редакторе ресурсов диалог и добавьте на 
него три ползунка и один переключатель. Присвойте им следующие иден- 
тификаторы: трс_уоБомЕ (регулятор общей громкости), трс_мотЕ (переключа- 
тель звука), трс_вАз$ (регулятор низких частот), трс ТвЕВЬЕ (регулятор высо- 
ких частот). 





Листинг 6.28. Использование класса СМ1хег 





// Объявляем наш класс 

СМ1хег пахег; 

// функция обработки сообщений диалогового окна 

ВООГ САШЬВАСК МахехРгос ( НИМР Вутар1а, ОТМТ меззаде, МРАВАМ чРагам, 
ТРАВАМ 1Рагат); 

// реализация диалоговой функции 

ВООЬБ САБШЪВАСК М1хехРхос (НИМО ВБурар1а, ЧТМТ пеззаде, МРАВАМ чРагат, 
ТРАВАМ 1Рагхам) 

( 

// получаем идентификаторы злементов управления 

зфаё1с НИМО НУо1аме = МОШЬ, ПВазз$ = МОШЬ, ВТхеб1е = МО, БМабе = №МЬ; 
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БУоТиме = беер19Т6ет ( ПмроЯр1а, ТОС УОГОМЕ); 


Юмосе = беер19Теем ( рупа9р19, 


ТОС МОТЕ) ; 


ПВаз$ = СбеЕр1а1Теем ( Вмпар19, ТОС _ВА$$); 
ИТкер1е = Сее0191Теет ( №мпЯа01а, ТОС_ТВЕВЬЕ); 


// идентификаторы компонентов микшера 
5$ае1с ОИОВО уо1ТР = 0, мабетр = 0, Базз1Тр = 0, 


// обрабатываем сообщения 


5и1Есй ( меззаде) 


{ 


сазе ИМ ТМТТОТАЬОС: 


{ 


ОМОВР пли = 0, пах = 0, 
// устанавливаем идентификатор окна 
плхег, еснимр ( Биурар1а); 


// инициализируем микшер 


пахег. Тр1ЕМ1хег (}; 


сиг = 0, 5фер = 0; 


сгер1етр 


= 0; 


// получаем идентификаторы компонентов управления микшера 
90110 = махегк.сбеесСек1тТО 


побетр = п1хег.сбееСек1тТр 
раз$10 = пахег.СееСЕх1Тр 
фгеб]1етр = пахег.СеесСек1тр (3); 


(0); 
(1); 
(2); 


// получаем значения параметров микшера 


илр = м1хег.СеЕМ1пМазеетк\о1 (); 


пах = м1хег.СесМахМазсет\Уо1 (); 


сиг = пахег. Се МазфехУа11е (); 


Зфер = мёхег. бес 5{ерМазфегУо1 


1Е ( ЗЕер == 0) Эфер = 5000; 


ТЕ ( пах == 0) 


{ 


Епаб1ей1паом ( ВУо1аме, 


} 


е1зе 
{ 
ЗепаМеззаде 


ЗепаМеззаае 


ЗепМеззаде 





ЗепаМеззаде 


( 


= 0; мах = 0; 


Е 

Р 

5 
| 


В 

Е. 

5 

| 


ПУоТиме, ТВМ ЗЕТВАМСЕМТМ, 


ТРАВАМ) 


БУоТлие, ТВМ ЗЕТВАМСЕМАХ, 
( .РАВАМ) 
БУо1аме, ТВМ ЗЕТТТСЕВЕО, 


ТРАВАМ) 


ип); 


0); 





(); 


шах); 





Га1зе); 


ВУо1име, ТВМ 5ЕТРОЗ, 


ТРАВАМ) 


саг = 


пихег.СеЕМ1пВаз$ 


( 


( ГОМС) 


0; 
); 


саг); 


( ИРАВАМ) 


( ИРАВАМ) 


( ИРАВАМ) 


( ИРАВАМ) 


1, 


0, 


0, 


мах / 


Этер, 
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пах = м1хег.СеМахВаз$ (); 
сиг = м1хег.СесВаззУа1ие (); 
ЗЕер = п1хег.Сес5$ерВаз$$ (); 
1Ё ( Зфер == 0) Зфер = 5000; 
1Ё ( шах == 0) 
{ 
Епаб1е\1паом ( НВаз$, Еа1$е); 


} 


е15е 
{ 

ЗепаМеззаде ( ИВаз$з, ТВМ ЗЕТВАМСЕМТМ, ( МРАВАМ) 0, 
( ТРАВАМ) пап); 

ЗепЧМеззаде ( НВаз5, ТВМ ЗЕТВАМСЕМАХ, ( МРАВАМ) 0, 
( ГРАВАМ) мах); 

ЗепМеззаае ( ПВаз$5, ТВМ ЗЕТТТСЕВЕО, ( МРАВАМ) тах / Зхер, 
( ГРАВАМ) 0); 

ЗепаМеззаде ( НВазз, ТВМ ЗЕТРОЗ, ( МРАВАМ) 1, 
( .РАВАМ) ( ТОМС) саг); 





ип = 0; мах = 0; сос = 0; 
плхег. сеМ1пТгеь1е (); 
иахег.Се<МахТгеЬ1е (); 
сиг = пахег.бесТгер]еУа1ае (); 
Зфсер = пахег.СесбферТгеб1е (); 
1Е ( Эфер == 0) 5Зхер = 5000; 
Е ( пах == 0) 


( 


вз 
` Е. 
хз 
ин 


Едаб]ей1паом ( РТгеб]е, Ёа15е); 
} 


е1 зе 
{ 

ЗепЧМеззаае ( ЮТгеб1е, ТВМ ЗЕТВАМСЕМТМ, ( УРАВАМ) 0, 
( ТРАВАМ) п1п); 

Зеп9Меззадце ( НТхеб1е, ТВМ_ ЗЕТВАМСЕМАХ, (МРАВАМ)О, 
( ТРАВАМ) шах); 

ЗепаМеззаде ( НТгеб1е, ТВМ ЗЕТТТСЕВЕО, ( МРАВАМ) пах / 5%ер, 
( ГРАВАМ) 0); 

ЗепаМеззаае ( НТгеб1е, ТВМ $ЕТРО$, (ИРАВАМ)1, 
( 


ТРАВАМ) ( ТОМС) сиг); 
} 
1Е ( шабетро == 0) 


Епаб1е\1паом ( ЮМоасе, Ёа1$е); 
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е15е 
{ 
сиг = пмухег Се МазкетхМисе (); 
1Е ( саг) 
{ 
Свеско19Вие оп ( Вира019, ТОС МОТЕ, ©гое); 
Епаб1ей1пАом ( ВУо1аме, Ёа15е); 
Епар1е\1п4ом ( ВВаз$, ЁЕа15е); 
Епаб1ей1паом ( ВТгеб1е, Ёа15е); 


} 
тебисп $гае; 
сазе УМ СОММАМО: 
5и1Есв ( ТОМОВО ( мРагам) ) 
{ 
сазе ТОСАМСЕЬ: 
сазе ТООК: 
Епар1а1оа ( Вмпа01а, мРагам); 
тесагп ТВОЕ; 
// обрабатываем выключатель звука 
сазе ТОС _МОТЕ: 
1Е ( НХМОВО ( иРагащ) == ВМ СЫТСКЕО) 
{ 
1Е ( 15019ВисбопСрескея ( пмпар19, ТОС УОБ МОТЕ) 
== ВЗТ СНЕСКЕР) 


пахег. бе МазехМисе ( 1}; 
Епаб1ей1паом { ВУо]ллме, ЁЕа15е); 
Епаб1ей1паом ( №Ваз$, Ёа15е); 
Епаб1ей1паом ( ВТгеб1е, Еа15е); 

} 

е15е 

{ 
пахег.беЕМазвегМиее (0); 
Епаб1ей1паом ( ВУо1аме, &гое); 
Епаб1е\1паом ( ВВаз5, гие); 
Епаб1ей1паом ( ВТееб1е, ©гоае); 


} 


Ьгеак; 
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сазе ММ Н$СВОБЬ: 
{ 


// обрабатываем регуляторы 
ОИОВО роз = 0; 
1Е ( ( НММО) 1Расам == БУоТоме) 


{ 


// получаем текущее положение ползунка 
роз = 5епаМеззаае ( ПУоТаме, ТВМ СЕТРОЗ, 0, 0); 
// устанавливаем новое значение 
пахег. Зе МазсегУа1ае ( роз); 


} 
е]1з5е 1Ё ( ( НММО) 1Рагам == ЪВаз$) 


{ 
роз = зепаМеззаде ( ПВазз, ТВМ СЕТРОЗ, 0, 0); 


плхег. Зе`ВаззУа1ле (‘роз); 


} 
е15е 1Е ( ( НММО) 1Рагам == БТхе ]е) 


{ 
роз = бЗепаМеззаде ( ЮТгер1е, ТВМ СЕТРОЗ, 0, 0); 


пахег.зесТгер1еУа1ое ( роз); 


) 
ргеак; 


} 
гесаги Ёа15е; 


} 


Как видите, нет ничего сложного в использовании класса сСмМ1хег. На этой 
оптимистической ноте я хотел бы завершить описание программирования 


звуковой платы и перейти к следующей главе. 


ГЛАВА 7 


Работа со звуком 


В этой главе я хочу познакомить читателя с программированием звука в 
операционных системах У/т4о\з. К сожалению, информации такого рода 
встречается очень и очень мало. Все так увлеклись базами данных и их со- 
ставляющими, что совсем забыли о том, что современный компьютер по- 
зволяет полностью заменить высококачественный музыкальный центр или 
звуковую студию, принося гораздо болыше пользы, а главное — удовольст- 
вия обычным пользователям. Трудно встретить человека, не слушающего 
музыку. Многие не только слушают, но и сами создают музыкальные про- 
извеления. А сколько пользы приносят обучающие компьютерные програм- 
мы для маленьких детей, развивая не только слух и чувство ритма, но и в 
игровой форме знакомя с музыкальной азбукой. Что ни говори, а без звука 
операционные системы \У/ш9о\5$ потеряли бы половину своей привлека- 
тельности и удобства. Без звука трудно себе представить современную игро- 
вую или производственную (отслеживающую какие-либо задачи в реальном 
времени) программу, поэтому я и решил в доступной форме представить 
читателю различные способы программирования звука в У/т4о\з. Мы рас- 
смотрим несколько базовых тем: 


1. Создание полноценного плеера аудиодисков средствами МСТ (Меда 
Сопно! пщег@се). 


2. Программирование МТОГ в УИп9о\5. 
3. Доступ к файлам в формате МРЗ. 


7.1. Создание плеера аудиодисков 


Для того чтобы создать полноценный плеер аудиодисков, нам понадобится 
всего одна функция МС]. Скажете невозможно? Я бы с вами согласил- 
ся, если бы не был убежден в обратном. Называется эта функция 
пс: ЗепаСоптапа, и предназначена она для передачи различных предопреде- 
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ленных сообщений устройству. В качестве устройства могут быть использо- 
ваны следующие варианты: аудио СО, устройство цифрового воспроизведе- 
ния звука или видео, МГУ, сканер, видеокассетный магнитофон, проигры- 
ватель видеодисков и стандартное устройство воспроизведения звука. 
Функция пс1ЗепСонщапа имеет четыре аргумента: 


С тореузсе — идентификатор открываемого устройства. Данный параметр 


не должен использоваться с сообщением МСТ ОРЕМ. 


С омза — специальное командное сообщение. Наиболее важные для нас 
сообщения приведены в табл. 7.1. 


| 


ЕамСоптала — дополнительные флаги команды. Возможные значения пе- 


речислены в табл. 7.2. 


| 





Имя сообщения 





МСТ ОРЕМ 
МСТ СТОЗЕ 


МСТ_СЕТРЕУСАР$ 


амРагаш — указатель на структуру, определяющую параметры команды. 


Таблица 7.1. Командные сообщения 


Описание 
Позволяет инициализировать любое устройство (файл) МС! 
Закрывает любое устройство (файл) МС! 


Позволяет получить информацию о любом устройстве МС! 


МСТ ТМЕО Позволяет получить информацию о любом устройстве МС! 
в виде строки 
МСТ РАЦЗЕ Приостанавливает текущее воспроизведение 
МСТ_ВЕЗОМЕ Возобновляет воспроизведение, приостановленное сообщением 
МСТ РАОЗЕ 
МСТ РТАУ Позволяет начать процесс воспроизведения 
МСТ ЗЕЕК Позволяет изменить текущую позицию воспроизведения 
МСТ ЗЕТ Позволяет настроить доступные параметры устройства 
МСТ _5ТАТОЗ Позволяет получить текущее состояние устройства 
МСТ ЗТОР Останавливает процесс воспроизведения 
Таблица 7.2. Дополнительные флаги 
Имя флага Описание 


МСТ ОРЕМ ТУРЕ ТР 


МСТ ОРЕМ ТУРЕ 


Определяет, что младшее слово параметра 1рзегрех1сеТуре 
содержит стандартный идентификатор устройства, а стар- 
шее — порядковый индекс 


Тип устройства будет включен в параметр 1рзЕгреу1сетуре 
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Таблица 7.2 (окончание) 





Имя флага Описание 


МСТ_МОТТЕУ Позволяет определить обработку уведомляющих сообщений 
для родительского окна 


МСТ ОРЕМ ЗНАВЕАВЬЕ — Устройство (файл) будет открыто как общий ресурс 


МСТ ИАТТ Заставляет устройство возвращать управление программе 
только после завершения операции 


МСТ АБ, БЕУТСЕ_ТР Указывает на то, что команда будет передана всем доступным 
устройствам МС! 


МСТ ЗТАТО$ МОЕ Позволяет установить в параметр чивекагт тип возвращаемо- 
го режима работы 

МСТ 5ТАТО$ ТТЕМ Позволяет установить тип возвращаемого параметра состо- 
ЯниЯ 


Кроме рассмотренной функции, нам понадобятся несколько структур МС: 
МСТ ОРЕМ_РАВМ$, МСТ СЕМЕВТС РАВМЗ, МСТ $ТАТОЗ РАВМ$, МСТ ЗЕТ РАВМЗ, 
МСТ РЬАУ РАВМ$, МСТ ЗЕЕК РАВМЗ И МСТ СЕТРЕУСАРЗ РАВМЗ. Каждая из них ис- 
пользуется для обработки определенного командного сообщения... 


Прежде чем написать код самого плеера, создадим три вспомогательных 
класса: мст, м$Е и тмзЕ. Первый класс будет отвечать за инициализацию уст- 
ройства МСТ, а два других помогут осуществить удобное форматирование 
параметров времени. Для удобства поместим все три класса в общий файл. 
В листинге 7.1 показан заголовочный файл МСИА, а в листинге 7.2 — файл 
реализации МСГ.срр. Не забудьте добавить в опции компоновщика ссылку 
на библиотеку УИтиила. Ш. 


Листинг 7.1. Файл МС|.В 





#$1пс1иае <итзузсем. В> 
// объявляем класс М5Е 


С1аз5$ М5Е 

{ 

руб] 1с: 
// конструктор по умолчанию 
МЗЕ () {м МЗЕ = 0; } 


// дополнительный конструктор с инициализацией 
М5Е ( ОМОВО АмМ5Е) { м М5Е = @ммзЕ; } 

// пустой деструктор 

МЕ () {} 


282 Часть |. Работа с аппаратными ресурсами в ИИтао\/$ 


// общедоступные функции для форматирования времени 





ВУТЕ СеЕМлт (); // получает составляющую минут 

ВУТЕ Себ5ес (); // получает составляющую секунд 

ВУТЕ СеЕгум (); // получает составляющую фреймов 
рг1уаее: 


// переменная для хранения времени 
ОМОВР п МЗЕ; 
}; // конец класса МЗЕ 
// объявляем класс ТМ$Е 
С1азз ТМ5Е 
{ 
рар11с: 
// первый конструктор 
ТМЗЕ () {м ТМЗЕ = 0; } 
// второй конструктор 
ТМЗЕ ( ВУТЕ Ткаск, ВУТЕ М1п, ВУТЕ 5ес, ВУТЕ Риа) 
{ 


=] 





// пакуем номер и время трека в ОМОВО 
М _ТМ5Е = МСТ МАКЕ ТМЗЕ ( Тгаск, Мл, $ес, Ея); 
} 
// пустой деструктор 
-ТМ$Е () {} 
// общедоступные функции для форматирования времени и номера трека 


ВУТЕ СеЕТгасКк (); // возвращает номер трека 
ВУТЕ СекМ1т (}; // получает составляющую минут 
ВУТЕ Сефбес (); // получает составляющую секунд 
ВУТЕ СееЕга (); // получает составляющую фреймов 
// определяем оператор для текущего значения 
орека®ог ОМОВО () { гебагп м ТМЗЕ; } 

ретуафе: 


// переменная для хранения текущего значения 
ООВ тм _ТМЭЕ; 

}; // конец класса ТМ%Е 

// объявляем класс МСТ 

с1аз$ МСТ 

{ 

раю11с: 
// конструктор по умолчанию и деструктор класса 
МСТ (); 
МСТ (}; 
// общедоступные функции 
ОМОВО ОрепМСт ( ОМОВО амреуТуре); // открывает устройство МСТ 
ОМОВО С1озе (); // закрывает устройство МСТ 
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ОМОВО СесМоае (); // получает текущий режим работы устройства МСТ 

ОМОВО Сее5хасаз ( ОМОВО @мЕ1ад); // получает текущее состояние 

уо1а зе М1паом ( НИМО В\па); // устанавливает родительское окно 

МСТЕВКОВ СефЕтгог (}; // получить последнюю ошибку МСТ 
ргосесфеа: 

// переменная для хранения идентификатора устройства МСТ 

МСТРЕУТСЕТР м МСТТО; 

НИМ м Б\па; // дескриптор родительского окна 

ОМОВР ЕхесСоптапа ( ипз1апеа 1пе иСоптапа, ПОМОКО амЕТад, 

ОМОВР дмРагам); // выполняет команду МСТ 

ри1уафе: 

// переменная для хранения последней ошибки МСТ 

МСТЕВВОВ п @мЕгтог; 

уо1а ЕгеемМСТ (); // закрывает все устройства МСТ, освобождая ресурсы 
}; // конец класса МСТ 





Ностоае "зедаЁх.В" 
НосТаае "ист.6“" 
// реализация класса МЗЕ 
ВУТЕ М5Е :: бебм1а () 
{ 
тесагп МСТ МЗЕ МТМОТЕ ( м М5Е); 
} 
ВУТЕ МЕ :: беф$ес () 
{ 
хекики МСТ МЗЕ ЗЕСОМО ( м МЗЕ); 
} 
ВУТЕ М$Е :: бебЕим () 
{ 
тесаги МСТ МЗЕ_ЕВАМЕ ( п МЕ); 
} 
// окончание реализации класса МЗЕ 
// реализация класса ТМ$5Е 
ВУТЕ ТМЗЕ :: бесТгаск () 
{ 
хесагп МСТ ТМ$ЗЕ ТВАСК ( м ТМ$Е); 
} 
ВУТЕ ТМЗЕ :: СебМ1а () 
{ 
гесигп МСТ ТМЗЕ_МТМОТЕ ( ш ТМ$Е); 
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ВУТЕ ТМЗЕ :: Сбеб5ес () 
{ 

тебаги МСТ ТМ$ЗЕ ЗЕСОМО ( м ТМ$Е); 
} 
ВУТЕ ТМ5Е :: бебЕим () 
{ 

тесагп МСТ ТМЗЕ ЕВАМЕ ( м ТМ$Е); 
} 
// окончание реализации класса ТМ5Е 
// реализация класса МСТ 
МСТ :: МСТ () // конструктор класса 
( 

м МСТТЬ = МОБ; 

м Бла = мы; 
} 
// деструктор класса 
МСТ :: МСТ () 
{ 

1Е ( м МСтто) 

{ 
Егеемст (); 
м МСТТЬ = МОБ; 


} 
// функция для открытия устройства МСТ 
ОМОВР МСТ :: ОрепмМСт ( ОМОВО амОеухТуре) 
{ 
МСТ ОРЕМ_РАВМ$ ис1ОрепРакиз; 
РМОВО 9мВез\а1&; 
// определяет тип устройства 
пс1ОрепРагтз .1рз&хБеу1сеТуре = (ЪРСЗТВ) ачеуТуре; 
ОМОВО ЧмЕ1ачз = МСТ ОРЕМ ТУРЕ ТО | МСТ ОРЕМ ТУРЕ | МСТ МАТ; 
// открываем устройство 
@Вези1$ = ЕхесСоптапа ( МСТ ОРЕМ, @мЕ1адз, 
( ОМОВО) ( ГРУОТО) &пс1ОрепРантз); 
1Е ( ЧмВезо1 == 0} 
{ 
// сохраняем идентификатор устройства 
м МСТТЬ = шс{ОрепРаитз .иОеу1сетр; 
} 
тесаги ЧмВезо1; 
} 
// функция для закрытия устройства МСТ 
БМОВО МСТ :: С1о$е () 
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МСТ СЕМЕВТС РАВМ$ шс1Сепег1сРагтз; 
пс1бепег1сРагиз . @мСа11раск = (ООВ) м _В\па; 
хесаги ЕхесСоптапа ( МСТ СТОЗЕ, 0, ( ПМОВО) вис1бепег1сРагтз); 
} 
// возвращает текущий режим работы 
ОМОВО МСТ ;: СбефМоае ()} 
{ 
тесаги Сес5$хасаз ( МСТ _5ТАТО$ МОПЕ); 
} 
// возвращает состояние для указанного режима 
ОИОВО МСТ :: беф5фабаз$ ( ОМОВО амЕ1а9) 
{ 
МСТ ЗТАТО$ РАВМ$ ис1$5аса5Рагиз; 
пс15сатизРагтз .мСа11раск = ( ОМОВО) м Рипа; 
ис156абазРагтз.мВебаги = 0; 
ис15сасазРатт$ .ОмТсем = мЕ1ад; 
ЕхесСомтапя ( МСТ УТАТО$, МСТ $ТАТО$ ТТЕМ, 
( ОМОВО) &мс15$хасазРаитз); 
тебаги шс15$абазРаттз. ЧмВебасп; 
} 
// устанавливает окно, которое будет получать уведомления МСТ 
у01а МСТ :: Зеб\1ааом ( НУМО Била) 
{ 
м АмМоа = Ипа; 
} 
// функция для выполнения указанной команды МСТ 
ОИОВО МСТ :: ЕхесСомтапа ( ипз1апеа 1п6 оСоптапа, ОМОВО амЕ1ад, 
РМОВО @мРагат) 


ОМОВО 9м“Ве5а1%; 
1Е ( дмВези1Е = мс15епаСоптапа ( м МСТТО, яСогапа, амЕТад, 
ЧмРагам) )} 


м АмЕсгог = амВеза; 
} 
тесигтп ЧмВе$у1<; 
} 
// функция возвращает последнюю ошибку МСТ 
МСТЕВВОВ МСТ :: СебЕгтог () сопз® 
{ 


тесаги м_@мЕсгог; 
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// функция закрывает все устройства МСТ и освобождает ресурсы 
уо1а МСТ :; Ехеемст (} 
{ 

пс15епаСоптапля ( МСТ АРТ РЕУТСЕ ТО, МСТ СЬОЗЕ, МСТ МАТТ, №11); 


Классы мзЕ и ТмЗЕ помогут нам работать с представлением времени. Для 
аудиодиска данные можно представить в удобном формате: минута, секунда 
и фрейм. Дополнительно для операций воспроизведения понадобится еще 
указать номер трека. Наши классы мзЕ и тмзЕ полностью решают эту задачу. 
Класс мст- является базовым и управляет глобальной работой МСТ. С его 
помошью мы открываем устройство МСТ, назначаем дескриптор окна, для 
которого будут посылаться уведомляющие сообщения МСУ, а также закры- 
ваем устройство и все используемые системные ресурсы. Этот класс предос- 
тавляет универсальную функцию ЕхесСоптала, с помошью которой выполня- 
ется передача всех управляющих команд устройству. 


Теперь у нас все готово для создания класса аудиоплеера. Назовем его 
СРАлазо и сделаем производным от мст. Добавим необходимые функции для 
управления плеером. Файл СОАцаю.1 показан в листинге 7.3. 





Листинг 7.3. Файл СРАцаю.в 


#1пс1аае "пс1.6“ 
// объявляем наш класс 
с1аз$ СРАБсато : роб11с МСТ 
{ 
рар11с: 
// определяем конструктор по умолчанию 
СРАзато (); 
// определяем пустой деструктор 
- СРАзазо (}; 
// определяем общедоступные функции класса 
РИОВО Ореп (}; // открываем устройство СР Айа1о 
// функции для управления дверцей СО-ВОМ 
уо1Я ОрепТгау (}; // открыть 
у014 С1озеТгау (); // закрыть 
// функции для управления воспроизведением 
уо1а Р1ауСр ( 1пе Ткасх5$хат®, 106 М1п5еаке, 116 Зесбфак®, 
11 ТгаскЕра, 1пе М1оЕлА, 106 ЗесЕпла}; // играть от и до 
уо1Я Р1ау3какЕЕраср ( ОМОВО дм5фате, ОМОВР ЧиЕпа); 
уо1А4 Раазеср (}; // приостановить воспроизведение 
%01А ВезимеСр (}; // продолжить воспроизведение 
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// перемещение по диску 

уо19 бееКТобфагЕ (); // в начало диска 

Уо1Я ЗееКТоЕра (); // в конец диска 

// проверка состояния 

Боо1 1$01зКк (); // есть ли диск 

Боо1 ТзВеаЧу (); // готово ли устройство 

// управление форматом представления данных 

у01а беЕГогпае (); // получить текущий формат 

уо1Я ЗекГогтафх ( ОМОВО ЭмКогтаф); // установить новый формат 
// получение различной информации 

РИОВР СеЕТгасКТуре ( ПМОВР ЧмТгаск); // тип трека 

ГИОВОЬ СеЕТгасКЬеп ( БМОВО дмТкаск); // длина трека 

ГИОВР СесТкаскРоз1Е1оп ( БИМОВО амТгаск); // позиция трека 


ОИОВР СекСоцпЕТкаскз (); // количество треков на диске 
ОМОВО СееТоба1ЁепСр (}; // полный размер диска 
РМОВО СеЕСакРоз$1Е1оп (}; // текущая позиция 
ОИОВО СееСигТгаск (); // текущий трек 
релуаее: 


}; 


// сервисные функции 

ОМОВР _деЕТкаскТао ( РИОВР ЧмТгаск, РИОВР 9мЕ1а9); // информация 
ОМОВЬ _зеек ( ОИОВР @амРоз, ОМОВР 9мЕ1а9); // перемещение по диску 
// окончание класса СРАЗА1о 


Как вы видите, в классе определены наиболее важные функции управления 
нашим устройством. На их основе можно реализовать практически любые 
возможности для аудиоплеера. Файл реализации (СПАцаАюЮ.срр) класса 
СоАис1о представлен в листинге 7.4. 


Листинг 7.4. Файл СОРАца.срр 





Нрс1аде "зЕдафх.В" 
Ностаде "СРАца1о. в" 
// конструктор класса 
СРАоЧ1о :: СРАаа1о (); 


{ 
} 


// сервисные функции 
ОМОВО СРАца1о :: _деЕТкасКкТюо ( ОМОВЬ амТгаск, РМОВР ЧиЕ1ач) 


{ 


МСТ 5ТАТО$ РАВМ$ пс15аеаз; 
пс15$абоз.ЧмТхгаск = амТгаск; 
пс15тасаз$.ЧмТеем = ОмЕ1ача; 
пс15ъабаз.амВебагиа = 0; 
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пс15еаеиз .ЧмСа11раск = ( ОМОВО) п ВИпа; 
ЕхесСошиапа ( МСТ $ТАТО$, МСТ ТВАСК | МСТ 5ТАТО$ ТТЕМ, 
( ОМОВО) &пс13а®аз); 
тебагп пс15сабаз .амВесаги; 
} 
РИОВО СРАзЧ1о :: _зеек ( ОМОВО @мРоз, РМОКР дмЕ1а9) 
{ 
МСТ ЗЕЕК_РАВМ$ пс1$еек; 
ис15еек.амГо = 9мРоз; 
ЧиЕ1ад |= МСТ МОТТЕУ; 
пс15ееКк. ЧиСа11Баск = ( ПМОВЬ) м В\а; 
геЕагп ЕхесСоштапЯ ( МСТ ЗЕЕК, ЭмЕ1аа, ( РМОВО) &с1$еек); 
} 
// общие функции управления и поддержки 
РИОВО СРАса1то :: Ореп () 
{ 
// открываем устройство СО аудио 
гекихр Орепмст ( МСТ РЕУТУРЕ СР АООТО); 
} 
уо1А СРАЗа1о :: ОрепТгау ()} 
{ 
МСТ _ЗЕТ_РАВМ5 шс15е{; 
пс15ес.АмСа11раск = ( РМОВО) м п\па; 
ЕхесСоптапа ( МСТ $ЕТ, МСТ ЗЕТ РООВ_ОРЕМ, ( ОИОВЬ) &пс15ее); 
} 
у019 СРАЗа1о :: С1озеТкау () 
{ 
МСТ ЗЕТ_РАВМ$ шс15ет; 
пс15ее.амСа11раск = ( БМОВО) м Вира; 
ЕхесСоптапя ( МСТ _5ЕТ, МСТ 5ЕТ_ПООВ_СЬОЗЕР, ( РМОВЬ) &с1бее); 
} 
уо1а СРАца1о ;: Р1ауСр ( 11 ТгасК5фаге, 1пе М1п5%еаке, 1пе 5ес5еагс, 
106 ТхаскКЕрЯ, 106 М1оЕпа, 106 5есЕпа) 


МСТ _РЬАУ РАВМ$ шс1Р1ау; 
ис1Р1ау.ЧмЕгом = МСТ МАКЕ ТМ5Е ( ТгасКк5еаге, М1п5фаге, Зесбфаге, 0); 
пс1Р1ау.ФиТо = МСТ МАКЕ ТМ5Е ( ТгаскЕпа, М1тЕра, 5есЕпа, 0); 
РИОВР ЧмЕ1ад = МСТ МОТТЕУ | МСТ ЕВОМ | МСТ ТО; 
пс1Р1ау.ЧмСа11Баск = ( ОМОВР) м ВИпа; 
ЕхесСопиапа ( МСТ_РЪАУ, @мЕ1ач, ( ОМОВО) ( ТРУОТО) &шс1Р1ау); 
} 
У019 СВАЯЧо :: Р1аубеагЕЕраСср ( ОМОВО ам5еаге, РМОКР амЕра) 
{ 
МСТ РЬАУ РАВМ$ шс1РЗау; 
ис1Р]ау.ЯмЕгом = Чи5баг®; 
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пс1Р1ау.ОмТо = амЕпа; 
ОИОВР амЕ1ач = МСТ МОТТЕУ | МСТ ЕВОМ | МСТ ТО; 
пс1Р1ауРагкиз .ЯмСа11Юаск = ( ОМОВЬ) м БИпа; 


ЕхесСоптаптая ( МСТ РЪАУ, @мЕ1ач, ( ОМОВО) ( ТРУОТО) вис1Р1ау); 

} 

у01А СРАца1о :: Раазеср () 

( 

МСТ СЕМЕВТС РАВМ$ шс1Сепег1с;, 
пс1бепег1с.9мСа11Ъаск = ( БМОВО) м ВИпа; 
ЕхесСопиата ( МСТ РАОЗЕ, 0, ( ПМОВО) &с1бепег1с); 

} 

у%01а СРАЗа1о :: Везитеср () 

{ 

МСТ СЕМЕВТС_РАВМ$ пс1Сепег1с; 
пс1Сепег1с.амСа11раск = ( ОМОВЬ) юм ВИпа; 
ЕхесСоптапа ( МСТ ВЕЗОМЕ, 0, ( ОМОВО) &с1Сепег1с); 

} 

у%014 СРАца1о :: ЗееКТобфатЕ () 

{ 
тегагп _зеек( 0, МСТ _5ЕЕК_ТО_5ТАВТ); 

} 

у01а СРАда1о :: ЗееКТоЕпа () 

{ 
тегагп _зеек( 0, МСТ $5ЕЕК ТО ЕМО); 

} 

роо1 СРАПА1о :: 13015$к () 

{ 
тегагп бес5еаеаз ( МСТ 5ТАТО$ МЕОТА РВЕЗЕМТ); 

} 

001 СРАИЧ1о :: ТзВеаау () 

{ 
тесигп Сее5еаеаз ( МСТ $ТАТО$ ВЕАБУ); 

} 

у01а СРАйа1о :: СееРоттае () 

{ 
хебигп Сеф5хаеаз ( МСТ $ТАТО$ ТТМЕ _РГОВМАТ); 

} 

у%019 СРАзафо :; ЗееКогтае ( ОМОВР 9мРогта®) 

{ 

МСТ _ЗЕТ_РАВМ5 пс15ефе; 

шс15ее.9мТ1аеЕГогтаЕ = ЧмЕогтаф; 

ЕхесСоптата ( МСТ_ЗЕТ, МСТ ЗЕТ ТТМЕ_РОВМАТ, 
( РИОКО) ( ГРУОТР) &юс15ее); 
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РИОВР СРАцато,:: бесТгаскТуре ( РОМОВО амТгаск) 
{ 
гебогп _деТгаскТпЕо ( @мТкаск, МСТ СРА_ЗТАТО$_ТУРЕ_ ТВАСК); 
} 
ОМОВОР СРАпа1о :: СеёТгаскЬетп ( ОМОВО @мТгхаск) 
{ 
тебогп _десТкаскТпЕо ( амТгаск, МСТ $5ТАТО$ ГЕМСТН); 
} 
ОИОВО СРАиа1о :: СекТкаскРоз1&1оп ( ОМОВКО амТгасКк} 
{ 
тебоги _дееТгаскТпЕо ( @мТкаск, МСТ ЗТАТО$ РОЗТТТОМ); 
} 
ОИОВО СРАза1о :; СееСоопЕТхаскз$ () 
{ 
хекогп Сесбеакиз ( МСТ 5ТАТО$ МОМВЕВ ОЕ ТВАСК$); 
} 
РИОВР СРАзато :: СеЕТофа1ерСср ()} 
{ 
гебагп бес5хабаз$ ( МСТ 5ТАТО$ ГЕМСТН); 
} 
РИОВО СРАЗало :: СееСихРоз1е1оп () 
{ 
гебогп Себ5бабаз ( МСТ 5ТАТО$ РОЗТТТОМ); 
} 
РИОВО СРАЦазо :: СееСохТхкасКк () 
{ 
гебагп Сес5бабаз ( МСТ ЗТАТО$ СОВВЕМТ ТВАСК); 


На этом нанг класс срАзазо можно считать полностью законченным. Вам 
осталось только создать красивый интерфейс и подключить к нему срАпа:с. 
Я не буду приводить полный код программы воспроизведения аудиодисков, 
а покажу только наиболее интересные моменты в создании плеера. Перед 
началом работы необходимо инициализировать класс соАза1о, как показано 
в листинге 7.5. Сразу хочу заметить, что в примерах подразумевается под- 
держка библиотеки МЕС. 


: Листинг 7.5. Инициализация класса срАцазо и получение информации 
: о треках 





// предположим, что класс плеера объявлен как СОАца1о са; 
// функция инициализации класса СРАда1о 
БооТ СМуР1ауег :: Тп1 () 
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1Е ( са.Ореп ()) 
тебахи Егоае; 
е1зе 


{ 


с9.5еЕ\1таом { БМа1пИпа); // указываем главное окно программы 


1Е ( !са.Т5Веаау ()) 
{ 
// устройство не готово 
} 
// устанавливаем формат представления данных 
са.ЗесЕогтае ( МСТ ЕОВМАТ ТМ5Е); 
// загружаем информацию о треках в список Ъ1$% У1ем 
ГоаЯТкаск$ (); 
} 
тебохп Еа15е; 
} 
// функция для загрузки треков в окно программы 
// предположим, что наш Т4зЕ У1ем назван ш_ТгаскЬ1 зе 
у019 СМуР1ауег :: РоаЧТгаск$ () 
{ 
СЗЕх1та 10Ео; 
М5Е п5Е; 
СПах Техё [30]; 
ИОВ ОмТгаск$ = 0; 
ОИОВО 9м$12е = 0; 
// предварительно очищаем список 
п Тгасх15$6.Бе]ефеА11Т%етз (); 
// определяем общее число треков на диске 
ЧиТхаск$ = са.СеЕСочрЕТгкаскз (); 
Рог (МТ 1 = 1; 1 <= `АмТхгасКз; 1++) 
{ 
// получаем длину первого трека 
п$Е = са.сееТгаскКЬераев (1); 
// форматируем строку в удобную для нас форму 
1пЕо.ЕКопта® ( "%02а : %024", шзЕ.СеемМ1т (), пзЕ.Сее$ес 
// создаем имя для трека 
зри1пЕЕЁ ( ТехЕ, " Трек %а", 1); 
// выводим информацию в [15 \У1ем 
п ТкаскЬ1зе.бееТбеюТехе (1-1, 0, Тех); 
п_ТкаскЬ1з. беетТееюТехе (1-1, 1, 1160); 
// считаем размер трека в мегабайтах 
@м3512е = ( ( изЕ.СебмМ1о () * 60) + пзЕ.Сеф$ес ()); 
Фм51те *= 75; // число секторов в одной секунде 
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Яи512е *= 2352; // размер в байтах одного сектора 
зрх1пе# ( Техё, "%1а", аЧм512е / 1048576); 
п ТгаскЬ15$е.бесТеешТехе (1-1, 2, Техё); 


А чтобы открыть лоток устройства, можно написать функцию, приведенную 
в листинге 7.6. 


Листинг 7.6. Пример функции для открывания лотка СО-КОМ 


Уо1а СМУуР1ауег :: ПБоог ( Боо1 БОреп) 


{ 
1Е ( БОреп) // открыть 
сЧ.ОрепТкау (); 
е1 зе 
са.С1озеТгау (); 
} 


Реализовать функцию паузы можно так, как это показано в листинге 7.7. 
Сделана она таким образом, что позволит включить паузу при первом вызо- 
ве и продолжить воспроизведение при втором вызове. 


Листинг 7.7. Пример функции для приостановки воспроизведения 


уо1А СМуР1ауег :: Раозе () 
{ 
1Е ( са.беЕМо4е () == МСТ _МОБЕ_РТАУ) // идет воспроизведение 
{ 
// устанавливаем паузу и останавливаем таймер воспроизведения 
са.Рачзеср (); 
К111Туаегк ( Му ТТМЕБ); 
} 
е1 зе 
{ 
// продолжаем воспроизведение и запускаем таймер 
са.Везимеср (); 
бееТиег ( МУ _ТТМЕВ, 1000, МОГ); 


Использовать таймер в программе необходимо, если вы хотите отслеживать 
время воспроизведения и отображать это в своей программе. Для воспроиз- 
ведения трека можно применить функцию из листинга 7.8. 
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‘Листинг 7.8. Пример функции воспроизведения 





у01а СМуР1ауег :: Р]ау ( ВУТЕ ТкасК) 

{ 
ТМ5Е м _5$агЕ; 
ТМ5Е м Епа; 
// определяем длину трека 
М5Е шзЕ = са.сееТкасКЬеп ( Тгаск); 
м Э6агЕ = ТМЗЕ ( Тгаск, 0, 0, 0); // начальная позиция 
шп Ета = ТМ$Е ( ТгкасКк, шзЕ.бееМ1т (), мзЕ.Сее5ес (), 

пзЕ.сесЕким ()); // конечная позиция 

са.Р1ау5еакгЕЕпЯСср ( м _5еаге, м Епа); // воспроизведение 
беЕТ1тег ( Му ТТМЕВ, 1000, МОГ); // включаем таймер 


При завершении работы программы следует правильно закрыть все ресурсы. 
Как это делается, показано в листинге 7.9. 


; Листинг 7.9. Завершение работы программы 





уо1а СМуР1ауег :: ОпСарсе1 () 
{ 
1Е ( МеззадеВох ( "Выйти из программы ?"), "Завершение работы", 
МВ_ТСОМО0ЕЗТТОМ | МВ ОКСАМСЕТ, | МВ_ОЕЕВОТТОМ1) == ТООК) 


1Е (са.ТзВеаау ()) 

{ 
с9.З6орСр (); // останавливаем, если нужно воспроизведение 
са.С1озе (); // закрываем устройство МСТ 
К111Тциег ( МУ ТТМЕВ); // выключаем таймер 

} 

С01а109 :: ОпСапсе1 (); 


И еще я хотел бы рассказать, как организовать быстрое перемещение по 
музыкальному треку во время воспроизведения. Предположим, что вы доба- 
вили ползунок в редакторе ресурсов, назвали его трс РОЗТТТОМ и определили 
для него переменную м Роз1Е1оп (Класс с$11ЧехсЕк1 из библиотеки МЕС). 
После этого добавьте обработку сообщения им н$свовь и заполните его так, 
как это сделано в листинге 7.10. Переменную диТгасктепаве следует опреде- 
лить заранее в классе так, чтобы она определяла полный размер текущего 
трека, а переменная п _СогТкаск должна хранить номер текущего трека. 
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у01А СМуР1ауег :: ОпН$ско11 ( ОТМТ п5ВСоае, ОТМТ пРоз, 
С$сго11Ваг* р$сго]11Ваг) 


1Е ( р5сго11Ваг->бефр19Сех1Тр () == ТОС _РОЗТТТОМ) 
{ 
// получаем текущую позицию 
РИОВР амСогРоз1Е1оп = м Роз161оп.бефРоз (); 
// вычисляем новую позицию 
РИОВР ЧмТ1иеРоз1Е1оп = ЧмТхаск ера / 1000; 
са.Р1ауТгаскСр ( м СагТкаск, ЧмСакРоз1Е1от / 60, ЧмСагРоз11опт % 60, 
п СагТгаск, @мТлерРо$11оп / 60, амТилеРоз1Е1опт % 60); 
} 
СЯ1а1о9 :: ОпН$ско11 ( пэВСоде, пРоз, р5сго]11Ваг); 


На этом можно завершить описание работы с МСГ для программирования 
устройства компакт-дисков. 


7.2. Программирование М! 


Интерфейс М! представляет собой цифровой протокол, основанный на 
передаче так называемых событий МПТ (МГ еуеп®. С помощью этих со- 
бытий можно управлять различными устройствами (например, синтезато- 
ром), подключенными к игровому порту звуковой карты. Еще раз напомню, 
что для корректной работы внешнего устройства необходим дополнитель- 
ный переходник. По протоколу интерфейса МТО! можно подключать по- 
следовательно несколько устройств. Для дополнительной поддержки МП] в 
1988 году был разработан специальный файловый формат (Запдата МТО 
Ее Рогта(), который четко оговаривал хранение событий МПТ и синхро- 
низирующей информации в одном файле. Поскольку файл содержал не са- 
му музыку, а только управляющие команды для звукового процессора, раз- 
мер файла получался очень небольшим. Однако в этом заключался и основ- 
ной недостаток данного формата: на разных по возможностям звуковых 
платах файл звучал неодинаково. Для того чтобы хоть немного исправить 
эту проблему, был принят дополнительный стандарт Сепега! МОТ, опреде- 
ляющий звучание для 175 инструментов. Теперь любой файл звучит одина- 
ково (по составу инструментов) на любой звуковой плате, однако качество 
звука все равно может сильно отличаться. Не буду влаваться в подробности 
данной проблемы, поскольку книга все-таки рассматривает программирова- 
ние, а не создание музыки. 
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Исходя из вышеизложенного, хочу представить вашему вниманию простой 
и удобный способ воспроизведения МШ!-файлов. Если вы планируете до- 
бавить в программу только возможность прослушивания таких файлов, этот 
вариант будет наиболее оптимальным. 


Итак, создадим новый класс и назовем его мтот. Заполните определение 
класса, согласно листингу 7.11. 





Листинг 7.11. Файл МШТ.И класса мтот 
Я 1пс1оае "Мизузсем. В" 
// объявление класса МТОТ 


с1аз$ МТОТ 
{ 
раБ11с: 
// конструктор по умолчанию 
МТОТ (); 
// пустой деструктор 
мтот () {} 


// общие функции 

У01Я Ореп ( сваг* з2Е11еМ1а1); // загружает файл МТОТ, открывает МСТ 

уо1а Р1ау (); // воспроизводит МТОТ-файл 

у01А 5Еор (); 

9019 С1озе (); // закрывает устройство МСТ 
рг1уаее: 


// останавливает воспроизведение 


// буфер для хранения текстовой строки 
СВаг $2ВаЕЁег[350]; 

// указатель на загруженный файл 

роо1 ББоаа; 

}; // окончание класса МТОТ 


Мы определили три функции: для открытия файла, воспроизведения и ос- 
тановки воспроизведения. Теперь напишем файл реализации класса мтот 
так, как показано в листинге 7.12. 


Листинг 7.12. Файл М!О1.срр класса мтот 





Ипс1оае "зЕдаЕх.В" 
Ностааде "мтот.в" 
// конструктор по умолчанию 
МТОГ :: МТОТ (} 
{ 
Бфоаа = Ёа1зе; 
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// функция Ореп 
МТРТ :: Ореп ( сваг* $7Е11еМ1а1) 
{ 
// сохраняем в классе указанный файл 
1Е ( 32211ем191) 
{ 
// форматируем командную строку 
зре1пЕЕ ( з2ВаЕЁЕег, "ореп \"%5\" Суре зеаоепсег а11аз МТОТРГАУЕВ", 
52Е11еМ191); 
// и передаем ее функции МСТ 
пс15епа5 г1па ( з2ВоЕЁег, 0, 0, 0); 
Б№юаа = $ гае; 


} 
// функция Р1ау 
МТОТ :: Р1ау () 
{ 
1Е ( 'БЪоаа) гебагп; 
// воспроизводим файл МТРТ 
пс15епа5©г1п9 ( "р1ау МТРТРЬАУЕВ Егом О", 0, 0, 0); 
} 
// функция 5®ор 
МТОТ :: 5®ор () 
{ 
1Е ( 'БТоаа) гебоагп; 
// останавливаем воспроизведение файла МТОТ 
пс1беп95%к1па ( "збор МТОТРГАУЕВ", 0, 0, 0); 
} 
// функция С1озе 
МТОТ :: С105е () 
{ 
Гоа = Еа15е; 
// закрываем устройство МСТ 
пс1бепа5Ег1па ( "с1о05е а11", 0, 0, 0); 


Вот и все. Класс полностью готов к работе. С его помощью вы можете про- 
слушать следующие типы файлов: пу4, пи4! и ги. В качестве основной 
функции выступает стандартная функция МС пс1$епа5егзпа. Она выполня- 
ет те же задачи, что и рассмотренная ранее пс15еп9Соттапа. Главным отли- 
чием является представление аргументов: все управляющие команды запи- 
сываются в виде текстовой строки. 


Написать плеер для воспроизведения МШЛТ-файлов можно и на базе рас- 
смотренного ранее класса мст. Создадим еще один класс см:а1, производ- 
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ный от класса мст, и определим набор функций, как показано в листин- 
ге 7.13. 


иостаае "мст.6" 
// объявляем класс 
с1аз$ СМ1А1 : риуБ11с МСТ 
{ 
рос: 
// конструктор по умолчанию и деструктор класса 
СМ1ат (); 
< Са () {} 
// общедоступные функции управления воспроизведением 
уо1а ОрепмтотТ ( ГРСЗТВ 1р$2М191Е11е); // открывает устройство МТОТ 
у014 Р1ауМТОТ (); 
у014 РацземТтрот (); // пауза 
уо1А Везитемтот (}; // продолжение воспроизведения после паузы 


// воспроизведение файла МТОТ 


\%014 ЗЕормТЬОТ (); // остановка воспроизведения 

уо1а ЗееКТо5бфахге (); // перейти в начало файла 

у01А ЗеекТоЕпа (); // перейти в конец файла 

// функции для получения информации 

Боо1 15Веа4у (); // готово ли устройство 

ОИОВР СеЕм1911ет (); // длина композиции МТОТ 

ГИОВР СесСигРоз1Е1оп (); // текущая позиция воспроизведения 

// дополнительные функции 

РИОВР беегогма® (); // получить текущий формат времени 

уо1а ЗеЕКогтаЕМз (); // миллисекунды 

уо1А ЗеегогтаЕ5МРТЕ 24 (); // 24 кадра 

у01А ЗескогиаЕ5МРТЕ 25 (); // 25 кадров 

у014 ЗеЕЕогтаЕ5МРТЕ 30 (); // 30 кадров 

у014 Зескогла&5МРТЕ ЗООВОР (); // 30 кадров 

ОМОВР СееМ1а1Тетро (); // получить текущий темп 

уо1а 5еЕМ191Тетро ( ПМОВР ЧмТепро); // установить новый темп 

%01а 5$еЕМ191СакРоге (); // выбрать МТРТ-порт по умолчанию 

%01а ЗеЕМ191МаррегРоге (); // выбрать МТОТ паррег порт 

%014 ЗауеМ1а1 ( ГРСЗТВ 1рз2М191Е11е); // сохранить в файл 
ре1уаЕе: 

у01а _зеек ( ПМОВР амЕпа, ОМОВР амЕ1ад); // установка позиции 
}; // окончание класса СМ1а1 


Теперь напишем реализацию функций для класса см1а1 (листинг 7.14). 
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Листинг 7.14. Файл СМ!.срр 
#1остаае "зЕЧаёх.В" 
#1остаае "СМ1а1.6" 


// реализация класса СМ191 
СМ1а1 :: СМ1а1 () // конструктор класса 
{ 
} 
уо1а СМ141 :: Орепмтрт ( ГРСЗТВ 1рз2М1атЕ11е) 
{ 
МСТ ОРЕМ_ РАВМ$ шс1Ореп; 
пс1Ореп.1рз&хЕ1етепЕМате = 1р$7М191Е11е; 
пс1Ореп.1рзгПеу1сеТуре = ( ГРСУТВ) МСТ РЕУТУРЕ ЗЕООЕМСЕВ; 
ОМОВР АмЕ1аа = МСТ_МАТТ | МСТ ОРЕМ ЕЪЕМЕМТ | 
МСТ ОРЕМ ТУРЕ! МСТ ОРЕМ ТУРЕ ТО; 
ЕхесСопиапЯ ( МСТ ОРЕМ, 9мЕ1ад, ( ОМОВО) ( ТРУОТР) &мс1Ореп); 
// сохраняем идентификатор открытого устройства 
п МСТТО = пс1Ореп.иБеу1сетр; 
} 
уо1а СМ1а1 :: РТаумтЬт () 
{ 
МСТ РГАУ РАВМ$ шс1Р1ау; 
пс1Р1ау.ЯмСа1]Баск = ( ОМОВР) м В\та; 
РМОВР 9мЕ1ад |= МСТ МОТТЕХ; 
ЕхесСопщара ( МСТ РЬАУ, @мЕ1ад, ( ПМОВО) ( ТРУОТО) вис1РТау); 
} 
у01а СМ1а1 :: Рацземтрт () 
{ 
МСТ СЕМЕВТС РАВМ$ тшс1бепег1с; 
пс1бепег1с.ЧмСа11раск = ( 0МОВО) м В\па; 
ЕхесСоптапа ( МСТ РАЦЗЕ, 0, ( ПМОВР) &пс1бепег1с); 
} 
уо1а СМ1а1 :: Везимемтрт () 
{ 
МСТ СЕМЕВТС РАВМ$ шс1Сбепег1с; 
пс1бепег1с.ЧмСа11Баск = { ПМОВО) м ВИпа; 
ЕхесСоптапа ( МСТ ВЕЗОМЕ, 0, ( ОМОВО) &мс1Сбепег1с); 
} 
уо1а СМ1а1 :: ЗеорМТОт () 
{ 
МСТ СЕМЕВТС РАВМ$ шс1Сепег1с; 
пс1бепег1с.мСа11Баск = ( ПОМОВЬ) м Вита; 
ЕхесСоптапЯ ( МСТ $ТОР, 0, ( РМОВО) &тс1бепет1с); 
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уо1а СМ1А1 :: ЗееКТо5жаге () 
{ 
гесигп _зеек ( 0, МСТ 5ЕЕК ТО $ТАВТ); 
} 
у01А СМ1а1 :: ЗеекТоЕлпа () 
{ 
гебсагп _зеек { 0, МСТ 5ЕЕК ТО ЕМО); 
} 
у014 СМ1АЧ1 :: _зеек ( ОМОВО амЕпа, ОМОВр амЕ1ач) 
{ 
МСТ_ЗЕЕК_РАВМ$ пс15еек; 
пс15еек.@мСа11Расх = ( ОМОВО) м В\па; 
пс15беек.амТо = ЯмЕпа; 
ЧмЕ1ач |= МСТ МОТТЕУ; 
ЕхесСоптапа ( МСТ $5ЕЕК, ОмЕ1ад, ( ОМОВО) &тс15еек); 
} 
5001 СМ141 :: Т5Веаау () 
{ 
геёагп Сее5фаеа$ ( МСТ $ТАТО$ ВЕАБУ); 
} 
РМОВО СМ1а1 :: Себмаа1Ъет () 
{ 
хесиги беЕ5хаеаз$ ( МСТ 5ТАТО$ БЕМСТН); 
} } 
БИОВР СМ1а1 :: СбееСакРоз1аелов () 
{ 
гесигкп бес5фабиз ( МСТ $ТАТО$ РОЗТТТОМ); 
} 
ОМОВО СМ1а1 :: СбееКогтае () 
{ 
хесигкп бес5аеаз$ ( МСТ 5ТАТО$ ТТМЕ ЕОВМАТ); 
} 
уо1А СМ1а1 :: ЗееГогтаМ$ () 
{ 
МСТ_ЗЕТ_РАВМ$ пс15еф; 
пс15еф. аиТиеРгогта®* = МСТ _ГОВМАТ МТЬЬТ$ЕСОМО$; 
ЕхесСоптарая { МСТ_ЗЕТ, МСТ _ЗЕТ _ТТМЕ ЕОВМАТ, 
( ОМОВО) ( ЬРУОТО} &тс15её); 
} 
Уо1а СМ1а1 :: бесГогпа&5МРТЕ_24 () 
{ 
МСТ ЗЕТ РАВМ$5 пшс15е%; 
тпс15ее. Чит иаеРогтае = МСТ ГОВМАТ $МРТЕ 24; 
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ЕхесСоптапа ( МСТ_$ЗЕТ, МСТ $5ЕТ ТТМЕ ГОВМАТ, 
( ОМОВО) ( ТРУОТР) &пс1$е®); 
} 
у01А СМ1а1 :: ЗееЕогиа®$МРТЕ_25 () 
{ 
МСТ ЗЕТ_ РАВМ5 пс15ес; 
пс15ее.аиТиегогиа® = МСТ РОВМАТ $МРТЕ 25; 
ЕхесСоптапа ( МСТ ЗЕТ, МСТ 5ЕТ ТТМЕ ЕОВМАТ, 
{ ОМОВО} ( ТРУОТО) &тс1$ее}; 
} 
у01А СМ1ат :: ЗесГогпае5МРТЕ_30 ({) 
{ 
МСТ _ЗЕТ РАВМ$ пс15е%; 
пс15ее.ЧмТипегогиа< = МСТ РОВМАТ_$МРТЕ_30; 
ЕхесСоштапя ( МСТ ЗЕТ, МСТ _ЗЕТ ТТМЕ РОВМАТ, 
( РИОВО) { ЪБРУОТЬ) &мс1$е®); 
} 
у01А СМ1а1 :: бееЕогиа&5МРТЕ ЗООВОР () 
{ - 
МСТ ЗЕТ_РАВМ$ тшс15ес; 
пс15еф. мТ1меГогта® = МСТ_ГОВМАТ_5МРТЕ_ЗООВОР; 
ЕхесСоптапа ( МСТ 5ЕТ, МСТ_$ЕТ_ ТТМЕ_ГОВМАТ, 
{ ОМОВО) ( ЪРУОТЬ) &мс1$е®); 
} 
РИОВР СМ1а1 :: СееМ1а1Тетро () 
{ 
гесагп бее5фафаз ( МСТ _5ЕО ЭТАТО$ ТЕМРО); 
} 
уо1а СМ1а1 :: 5$еМ1а1Тетро ({ РМОЕР амтТетро) 
{ 
гебигп бее5фабиз ( МСТ 5ЕО ЗТАТО$ _ТЕМРО); 
} 
у01А СМ1а1 :: 5$еЕМ191СотРоге () 
{ 
МСТ 5ЕО ЗЕТ_РАВМ$ пс1Зеазек; 
пс15еа5ее.ЯмРоге = МСТ 5ЕО МОМЕ; 
ЕхесСогтапая { МСТ _$ЕТ, МСТ _5ЕО ЗЕТ_РОВТ, 
( РМОВО) ( ТРУОТР) &тс15еабеф); 
} 
У01А СМ191 :: $еМ191МаррегРог® () 
{ 
МСТ _5ЕО_ЗЕТ_РАВМ5 пс15еа5ес; 
пс15еабеф.ЧмРоге = МТОТ_МАРРЕВ; 
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ЕхесСомтапа ( МСТ ЗЕТ, МСТ $5ЕО 5ЕТ РОВТ, 
( ОРИОВО) ( БРУОТЬ) &тс15еа5еф); 
} 
у01Я СМ191 :: Зауем1а1 ({ БРСЗУТВ 1р$2М1а91Е11е) 
{ 
МСТ _ЗАУЕ _РАВМ$ тшс1бауе; 
пс15а\уе. 1рЕ11епаще = 1рз2М1а1Е11е; 
ЕхесСопиапая ( МСТ ЗАУЕ, МСТ ЗАМЕ ЕТЬЕ, ( ОМОВО) &тс15ауе); 


Вот у нас и получился полноценный класс для воспроизведения МШ]- 
файлов. На этом работу с МОТ будем считать завершенной. 


7.3. Доступ к файлам в формате МР3З 


Говорить о данном формате не имеет смысла, поскольку с ним знаком 
практически каждый. Как реализовать поддержку кодирования и декодиро- 
вания файлов МР3З в программе, рассказывать не буду, поскольку эту ин- 
формацию можно найти в Интернете. Мы поговорим о том, как воспроиз- 
вести файл МР3, а также как модифицировать информационный заголовок 
в таком файле. 


Для воспроизведения МР3З воспользуемся уже знакомым нам интерфейсом 
МСТ. Напишем новый класс плеера и назовем его смрз. В опции компо- 
новщика следует добавить ссылку на библиотеку УЁм32.16. Заголовочный 
файл нашего класса представлен в листинге 7.15. 





Листинг 7.15. Файл СМрЗ.В 
{1остаае <уЁм.В> 
// объявление класса СМр3З 
с1аз$ СМр3З 
{ 
рар11с: 
СМр3 (); // конструктор по умолчанию 
-СМр3З (); // деструктор 


// общие функции управления 
у01А Ореп (); // открыть файл МРЗ 


уо1А Р1ау (); // воспроизведение файла 
у01А Рацзе (); // пауза 
уо1а 56ор (); // стоп 


// установить параметры родительского окна 
уо1А ЗехИ1пРагам ( НММО ВИпа, НТМЗТАМСЕ ВТо5${); 
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ргтуаее: 
НУМР м Б\оа; // дескриптор родительского окна 
НТМУТАМСЕ м ВТп3з&; // дескриптор вызывающего приложения 
НИУМР м МРЗ; // дескриптор устройства 
Боот м ЮРацзе; // статус воспроизведения 


}; 


Теперь напишем реализацию класса, согласно листингу 7.16. 


‚ Листинг 7.16. Файл СМр3.срр 





$10с1а4е "зЕдаЕх.В" 
#1остаае "СМрЗ.в" 
#1остаае "уЁи. в" 

// реализация класса СМр3З 
СМрЗ :: СМр3З () 


{ 
ш_ Иа = Юы; 
п МРЗ = МОБ; 
м ИГазе = МОБ; 
п ЮРацзе = ЁЕа]1зе; 
} 
СМрЗ :: -СМр3 () 
{ 
// освобождаем ресурсы 
1Ё (м МРЗ) МСТИпарезегоу ( м МРЗ); 
} 
Уо14 СМр3 :: ЗеИ1пРагам ( НИУМО ВИпа, НТМ5ТАМСЕ ВТпз®) 
{ 
ТЕ ( П\оа && ВТо$Е) 


{ 
п ВИпа = Вира; 
п БТазЕ = 613%; 


} 
$у01а СМрЗ :: Ореп () 
{ 
1Е ( ( !м В\оа) && ( м БТозе)) гебогп; 
СЕ11е1а1о4 Е11е ( ТВОЕ, МОШ., МОЬЪ, ОЕМ_НТРЕВЕАРОМЬУ, 
"МРЗ Е11ез (*.пр3) |*.пр3| |"); 
1Е ( Е11е.роМоаа1 () == ТРОК) 
{ 
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// открываем устройство МСТ 
п МРЗ = МСТ\пЯСгеа&е ( м ПИпа, м ВТпзе, №5 СНТЬО 
| МСТИМОЕ ‚МОМЕМО | МСТИМОЕ МОРТАУВАВ, Е1]е.м оЁп.1рзекЕШе); 


} 
уо1а СМрЗ :: Р1ау () 
{ 
1Е( !м_МРЗ) гебагп; 
МСТИпаНоме ( п МРЗ); // исходное положение файла 
МСТИПАР1ау ( м МРЗ); // начинаем воспроизведение 
} 
У01а СМр3 :: Раизе () 
{ 
1Е ( а МРЗ) гебоги; 
1Е ( м БРацзе) 
{ 
МСТипаВезите ( м МР3З); 
п БРацзе = ЁЕа13е; 
} 
е1 зе 
{ 
мСТипаРаизе ( м МРЗ); 
п ЬРачзе = &гие; 


} 

уо1а СМр3 :: 5®ор () 

{ 
1Е( п МРЗ) гебаго; 
МСТИпа$Еор ( м МР3З); 
п БРалзе = Еа15$е; 


Вот у нас и получился простейший класс для воспроизведения файлов 
в формате МРЗ. Все достаточно наглядно и не требует дополнительных 
комментариев. Хочу сказать только два слова о назначении функции 
Зе 1пРагам. С помощью данной функции мы устанавливаем для нашего 
класса дескрипторы родительского окна и приложения, поскольку этого 
требует интерфейс МСТ. После объявления класса смрз следует сразу вы- 
звать функцию Зек\1пРагат, а только потом использовать управляющие 


. функции. 


А теперь рассмотрим, как можно прочитать и модифицировать информа- 
ционный заголовок файла МРЗ. Для этого потребуется написать класс 
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СМРЗТиЕо, НО прежде познакомимся с заголовком файла МР3З. Формат заго- 
ловка приведен в табл. 7.3. 


Таблица 7.3. Заголовок файла МРЗ 


Описание 

Биты синхронизации установлены в 1 

Биты синхронизации установлены в 1 

Номер версии 

Индекс уровня (1 — 1 ауег 3, 2 — 1ауег 2, 3 — 1ауег 1) 


Защита контрольной суммой (СВС) 


| Биты 

З 

2 

2 

1 

2 4 Скорость передачи (битов в секунду) 

2 Частота дискретизации 

1 При установке в 1 используется добавочный слот 
1 

2 

2 

1 

1 

2 


Частный 


Режим (0 — стерео, 1 — объединенное стерео, 2 — два канала, 
3 — один канал} 


Расширенный режим 
Авторское право (1 — есть) 
Оригинал (1 — оригинальная композиция) 


Предыскажение 


Кроме перечисленного в таблице формата, файл может содержать дополни- 
тельные сведения (128 байт): полное имя файла, данные об исполнителе, 
название альбома, стиль композиции и дату создания. 


Рассмотрим первый файл класса (СМр3З Ю.П), представленный в листин- 
ге 7.17. 


Листинг 7.17. Файл СМр3З Ю.П 


// сначала определим список музыкальных стилей 

5+ас1с сВаг* Сбергез [] = { "Вез", "С1азз1с Воск", "СоспЕгку", "Бапсе", 
"215со", "Капк", "Сбгопае", "Н1р-Нор", "Фаг2", "Мефа1", "Мем Аде", 
"О1Ч1ез", "ОфВег", "Рор", "В&В", "Вар", "Веддае", "Воск", "Тесвпо", 
"ТпЧо$г1а1", "А1бегпас1уе", "5ка", "БеаЕВ Мефа1", "Ргапк$", 
"Зонпасгаск", "Еаго-ТесВпо", "АпЬ1епе", "Теар Нор", "Уоса1", "За22+Еапк", 
"Коз1оп", "Тгапсе", "С1аз$1са1", "Тазегимепса1", "Ас1А", "Нодзе", "баше", 
"боппа С11р", "бозре1", "М№о1зе", "А1егпаб1уе Воск", "Вазз", "5001", 
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"Рипк", "5расе", "МеЯ1Еа®1уе", "ТпзЕгатеп$а1 Рор", "Тазегитепва1 Воск", 
"ЕСЬП1с", "Софр1с", "РагКкмауе", "Тесрпо-Тпачз%хг1а]1", "Е1ес®гоп1с", 
"Рор-Ео1К", "Еагодапсе", "Ргеат", "болЕВегп Воск", "Сомеау", "Со", 
"бСапазба Вар", "Тор 40", "Свг15&1ап Вар", "Рор/РипК", "Запо1е", 
"Маф1уе Амег1сап", "СаБагее", "Мем Мауе", "РзусВе@е11с", "Вауе", 
"Зпомсопез", "Тга1]ег", "То-ЁР1", "Тг1ра1", "Ас1ла Рапк", "Ас1а Фаг2", 
"Ро1ка", “"Вефго", "Миз1са1", "Воск & Во11", "НагЯ Воск", "Го1к", 
"Ео1к/Коск", “МаЕ1опа1 Ео1К", "5и1пд", "ЕазЕ-Еиз1оп", "Верор", "Гафт", 
"Ве\у1\а1", "Се]1{1с", "В1ае Сбгаз$", " АуапЕдагае", "боЕБ1с Воск", 
"Ргодгез51\уе Воск", "Рзусреае11с Воск", "Зутрьоп1с Воск", "51ом Воск", 
"В1ч Вапа", "Свогаз", "Еазу Ь1$6еп1пд", "Асой$Е1с", "Натойсг", "5реесВ", 
"СвВапзоп", "Орега", "Свапрег Миз1с", "Зопафа", "Зупрвопу", "Воо®у Вазз", 
"Реааз", "Рогп Сгооуе", "Зае1ге", "51ом Зам", "Саб", "Тапдо", "Запфа", 
"Ео1к1оге", "Ва]1аа", "Ромег Ва11аЯ", "ВВуЕБт1с $001", "Егеез®у1е", | 
"Роеё", "РипКк Воск", "Огош $010", "А Саре!11а", "Еако-Ноцзе", 
"Рапсе На11", "боа", "Ргим & Ваз5", "СТаб-Ноцзе", "Нагасоге", "Теггок", 
"Тпа1е", "Вг1е Рор", "Медегрипк", "Ро1зК РирпК", "Веаф", 
"Срг1$Е1ап Сапдз$а Вар", "Неауу Меба1", "В1аск Мефа1", "Сгоззоуег", 
"Сопсетрогагу СЬг1з%1ап", "СВг1$1ап Воск", "Мекепаие", "ба1за", 
"Тхазн Мефа1", "Ап1е", "ОРор", "ЗупЕВ Рор" }; 
// количество стилей 
#АеЁЕ1пе СЕМВЕ$ СООМТ ( ( 116) ( ( э1теоЕ бепгез) / ( з1хеоЕ 
Сепге$[0]))) 

// частота дискретизации 
$саЕ1с 116 1батр1еВаее[3] [3] = 
{ 

{ 32000, 16000, 8000 }, { 22050, 24000, 16000 }, 

{ 44100, 48000, 32000 } 
}; 
// скорость передачи данных 
эбаЕ1с 106 1В1Вафе [6] [16] = 


‚ 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 144, 160, 0 }, 

‚ 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 144, 160, 0 }, 

‚ 32, 48, 56, 64, 80, 96, 112, 128, 144, 160, 176, 192, 224, 256, 0 }, 
32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320, 0 }, 
‚ 32, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320, 384, 0 }, 
‚ 32, 64, 96, 128, 160, 192, 224, 256, 288, 320, 352, 384, 416, 448, 


= ---ф 
= осбооо 
` 


0 

}; 

с1аз$ СМрЗТпЕо 

{ 

рую11с: 
СМр3ЗТаРо (); 


306 Часть /. Работа с аппаратными ресурсами в И/паои$ 


У1г60а1 -СМр3ЗТпЕо (); 

// функция для загрузки файла МРЗ 

у0о1А Ореп ( сваг* $2Мр3ЗЕ11е); 

// сохранить информацию в файл МРЗ 

%014 Зауе ( сраг* $32Мр3ЗЕ11е); 

// функции для получения текущих значений 


10е бекуУег$1оп () сопз®е; // номер версии 

10 СебГгауег () соп5$®; // номер уровня 

Боо1 Т$СВС () сопз®; // защита СВС 

17е бееВ1егафе () сопзе; // скорость передачи данных 
10Е Сбеббапр1еКафе () сопз®; // частота дискретизации 
Ьоо1 ТэРг1уафе {) сопз®; // частный 

1пЕ бебМо4е () сопзе; // режим 

Боо1 Т5Соруг19а6е () сопз®Е; // авторское право 

Боо1 130т191па1 {() сопзе; // оригинал 


ОМОВО Сеё$12е () сопзе; // размер файла 
у01А СбееТ1Е1е ( сВаг* роЕЁЕег) соп$е; // название композиции 
у01А СебАг&15Е ( сваг* БаЕЁЕег) соп5е; // имя исполнителя 
у01а сСееА1риш ( сваг* РаЕЁЕег) сопз®; // название альбома 
%У014 Себуеаг ( спаг* БаЕЁЕег) сопз®; // год записи альбома 
уо1А беЕСопмепе ( сраг* РаЕЁег) сопз®; // комментарии 
\у01Я Сесбепге ( сваг* БоЕЕег) соп5®; // стиль музыки 
// функции для установки параметров 
Уо1А ЗееТ1Е1е ( сраг* рз2Т1&1е); 
%у014 Зе{АгЕ15Е ( сраг* р52Аг®15%); 
%014 ЗезА1Бим ( сваг* рз2А1Бим); 
%014 ЗефУеаг ( сВаг* рз2\Уеаг); 
У014 ЗеСоптепе ( сваг* р52Соптепе); 
уо1А Зеебепге ( 11е 1бепге); 
рге1уасе: 
// номер версии формата 
епит МРЕС_УЕВЗТОМ 
{ 
МРЕС_25, // 2.5 
МРЕС_0, // резерв 
МРЕС_2, // 2.0 
МРЕС 1 // 1.0 
}; 
// номер уровня пересмотра 
епим МРЕС_ ТАУЕВ 
{ 
ТАУЕВ_О, // резерв 
ТАУЕВ_3, // Тауег 3 


Глава 7. Работа со звуком 307 


ТАУЕВ_ 2, // Тауег 2 
ТАУЕВ_1 // Тауег 1 
}; 
// тип режима 
епим МРЕС МОРЕ 
{ 
ЗТЕВЕО, // Эхегео 
ЧОТМТ ЭТЕВЕО, // Зо1пе 5%егео 
РОАЪ СНАММЕТ, // Оаа1 Сваппе1 
ЗТМСТЕ СНАММЕТ // $51191е Сваппе1 
}; 
// структура для хранения заголовка файла МРЗ 
$ЕгисЕ МРЗНЕАРЕК 
{ 
1пЕ 15упс; 
10 1Уег$1оп; 
116 1Тауег; 
10Е 1С8ВС; 
106 1В1габе; 
1706 1бапр1еКаке; 
106 1Раа; 
1рЕ 1Рг1уаке; 
10 1Моае; 
1ре 1МоаеЕхе; 
11Е 1Сору; 
116 10г:191та1; 
1ртЕ Епр; 
РИОВО 9м5127е; 
}; 
МРЗНЕАРЕВ рах Мр3; 
сраг $2Т141е[30]; // название композиции 
сраг $7Аг1$е[30]; // имя исполнителя 
сваг $7А1Рит[30]; // название альбома 
сваг з2Уеаг[4]; // год записи альбома 
СРаг з7Сопмепе [30]; // комментарии 
116 м 1бепге; // стиль музыки 
// функция для получения указанного параметра 
ип51отеЯ 11 деЕУа]1ае ( ОМОВР Ч\уУа1ае, зп519пеЧ 11 эфагк, 
ип$1апеа 1пе 1еп); 
СВаг* _х1аВе Тема ( сБаг* 5%г); // удаление пробелов справа в строке 
}; // окончание класса СМр3ЗТпЁо 


А теперь реализуем наш класс так, как показано в листинге 7.18. 
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: Листинг 7.18. Файл СМр3Зш.срр 





#1ос1а4е "5ЕЧаЁх.В" 
#ф1осТоае "Мр3ЗТпЕо.в" 
СМр3ЗТпЕо :: СМр3ТоЕо () 
{ 
1Сепге = 0; 
} 
СМр3ЗТпЕо :: -СМр3ЗТрЕо () 
{ 
} 
11$19пеа 1пЕ СМр3ЗТрЕо :: дееУа1ае ( ПМОВКО а\Уа1ае, опз1апед 118 эфагк, 
и1519пе4 116 1еп) 


гебатп ( ауУа1ае >> ( эбаг® - 1)) & ( (1 << 1еп) - 1); 
} 
сВаг* СМр3ЗТрЕо :: _т1ареТкии ( сваг* э%г) 
{ 
10 1 = 5&:1еп ( $%5г); 
у111е ( (--1) > 0 4&& 1353расе ( з%г [1]) 
{ 
$6и[1] = '\0'; 
} 
гееагп ( 56г); 
} 
\у014а СМрЗТрЕо :: Ореп ( сраг* $2Мр3ЗЕ11е) 
{ 
НАМОТЕ БЕ11е = МОГ; 
// открываем МР3З-файл 
1Е ( ( БЕ11е = СгеабеЕ11е ( $з2Мр3ЗЕ11е, СЕМЕВТС_ВЕАО, ЕТЬЕ ЗНАВЕ_ВЕАО, 
МОТТ, ОРЕМ ЕХТЗТТКС, 0, МОТТ)) != ТМУАБТО НАМОТЕ УАГОЕ) 


РМОВО амТрЁо = 0, ФВеадВусез = 0, мЕ11е51те = 0; 

сваг $2Тетр [40]; 

// получаем размер файла 

ЧмЕ11е512е = СехЕ11е517те ( ВЕ11]е, №011); 

Вах_Мр3.4и512е = 9мЕ11е512е; 

// устанавливаем маркер чтения на начало файла 

ЗееЕ11еРо1рсег ( ВЕЛе, 0, 0, ЕТТЕ ВЕСТМ); 

// читаем заголовок файла размером 4 байта ( используются 32 бита) 

ВеаЧЕ11е ( №Е11е, &32Тетр, 4, &ЧмКеаЯВусез, МО); 

// сохраняем из буфера нужные данные 

ФЧмТоЕо = { ОМОВО) ({ { { $2Тетр[0] & 255) << 24) | 

{ ( з2Тетр[1] & 255) << 16) | { { $2Тетр[2] & 255) << 8) | 
{ ( 52Темр[3] & 255))); 
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// распаковываем данные и сохраняем в структуру 


паг Мр3 


Вахг_Мр3. 


раг Мр3З 


Вах Мр3З. 


Баг _Мр3 
Баг Мр3З 


Баг Мр3З. 
Вах _МрЗ. 
раг Мр3з. 
раг Мр3З. 
Баг МР3З. 
Ю@хг Мрз. 


раг Мр3з 


.1бупс = дебУа1ае .{ ЧмТпЕо, 22, 11); 


1Уегз1оп = _дебУа1ае ( ЧмтТПЕо, 20, 2); 


„.1Тауег = _дефУа1ое ( ЧмТпЕо, 18, 2); 


1СВС = _декУа1ае ( @амТпЕо, 17, 


1); 


.1В1Егаке = дефУа1ае ( ЧиТпЕо, 13, 4); 
.15апр1еКафе = _деб\Уа1ще ( амТпЕо, 11, 2); 


1Раа = _дееУа1ае ( амТтЕо, 10, 
1Рг1уасе = _дебУа1ае ( амТпЕо, 
1Моде = декУа1ле ( дмТпЕо, 7, 
1МоаеЕхЕ = _чекУа1ае { @и1ТтЕо, 
1Сору = _деУа1ае ( @мТпЕо, 4, 


.Ешр = _дефУа]ще ( @мТоЕо, 1, 


1); 


10.191па1 = _деЕУа1ое ( аиТпЕо, 3, 
2); 


1); 


// проверяем наличие дополнительной информации 
Зее Р11еРо1псег ( №Е11е, -128, 0, ЕТГШЕ ЕМО); 
52Тепр[3] = '\0'; 
ВеаЯЕ11е ( ЬЕ11е, $2Тетр, 3, &ЧмВеааВуеез, МОШ,); 


1Е (! 
{ 


( зЕгсшр ( з2Тешр, "ТАС")}) 


// есть дополнительная информация 
32Тетр[30] = '\0'; 

// название композиции 

ВеаЯЕ11е ( РЕ11е, $з7Тепр, 30, &мВеаЯВуез, МОТ); 
зЕгсру ( 52Т1%1е, _г1аПЕТкема ( 52Тетр)); 


// имя исполнителя 
$2Темр[30] = '\0'; 
ВеачЕ11е ( РЕ11е, $з27Тепр, 30, &ЧмВеааВуЕез, №011); 


зЕгсру ( 52АгЕ15Е, _х1аНеТкма ( $2Тепр)); 


// название альбома 
32Тетр[30] = '\0'; 

ВеааЕ11е ( ПЕ11е, $2Тепр, 30, &ЧмВеааВуеез, МО); 
зЕгсру ( 52А1Ьит, _г1а9ПеТкла ( э2Тетр)); 


// год записи альбома 
$7Тепр[4] = '\0'; 

Веааг11е ( №Е11е, з7Тепр, 4, &АмВеааВукез, МО); 
зЕгсру ( з=Уеаг, _г19РЕТт4а ( 572Тепр)); 


// комментарии 
32Тетр[30] = '\0'; 
ВеаЧЕ11е { ВЕ11е, з2Тетр, 30, &@мВеаЯВуеез, МОГ); 
зЕгсру ( э2Соптепе, _г19йеТк\а ( $7Тетр)); 


// стиль музыки 
т 1Серге = СЕМВЕ$ СООМТ + 1; 
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ВеааЕ11е ( ВЕ11]е, $2Тетр, 1, &ЧмВеаЧВу$ез, МОЬЬ); 
п 1бепге = 52Тепр [0]; 
} 
// закрываем файл 
С1озеНапа1е ( №Е11е); 
} 
} 
11Е СМр3ЗТоЕо :: бебуУегз1оп () 
{ 
эи1есв ( Раг Мр3З.1Уег51оп) 
{ 
сазе 0: // 2.5 
гебагп МРЕС 25; 
сазе 1: // гезегу 
тебсагп МРЕС 0; 
сазе 2: // 2.0 
тебагп МРЕС_2; 
сазе 3: // 1.0. 
гебагп МРЕС 1; 
} 
гебагп -1; 
} 
116 СМр3ЗТпЕо :: СееТауег () сопзЕ 
{ 
З\ТЕСВ ( ваг_МрЗ.1Ъауек ) 
{ 
сазе 0: // резерв 
гебагп ТАУЕВ_0; 
сазе 1: // Тауег 3 
гебагп ТАУЕК_3; 
сазе 2: // Тауег 2 
гебагп ТАУЕВ_2; 
сазе 3: // Тауег 1 
гебогп ТАУЕВ_1; 
} 
гебатп -1; 
} 
Роо1 СМр3ЗТпЕо :: Т5СВС () соп5® 
{ 
1Е ( Баг Мр3З.1СВС) 
тебагп $гце; 
геЕотп Еа]15е; 
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116 СМрЗТпЕо :: сбееВ1Егафе (}) сопз® 
{ 
$и1Есп ( Баг _Мр3.1Уег51оп) 
{ 
сазе МРЕС_1: 
{ 
з\1ЕсВ ( Раг_Мр3З.1ТЪауег) 
{ 
сазе ТАУЕВ 1: 
гебигп 1В1(Вафке[5] [паг Мр3.1В1егаке]; 
сазе ТАУЕВ_2: 
гебагп 1В1%Вафе[4] [таг Мр3.1Ваегаке]; 
сазе ПАУЕВ_3: 
гегогп 1В1%Кафе[3] [паг Мр3.1В1егаее]; 


} 
сазе МРЕС_2: 
сазе МРЕб_25: 
{ 
зилесв ( Вах Мр3. Шауег) 
{ 
сазе ТАУЕВ_1: 
тебигп 1В1{Вафе[2] [пах Мр3З.1В1егаке]; 
сазе ТАУЕВ_2: 
геёагп 1В1{Вафе[1] [паг Мр3З.1В1Егафе]; 
сазе ТАУЕВ_З3: 
тебагп 1ВВаке[0] [паг Мр3.1В1егаее]; 


} 
гебиахгр -1; 
} 
11 СМр3ЗТоЕо :: беббатр1еВаее (}) сопзе 
{ 
з\1ссН ( Баг Мр3.1Уег$1оп) 
{ 
сазе МРЕС 1: 
{ 
5\1ЕсЬ ( Баг Мр3З.15атр1еВафке) 
{ 
сазе 0: 
гебагп 1батр1еВафе[3] [0]; 
сазе 1: 
гебагп 1Збатр1еВаее[3] [1]; 
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сазе 2: 
гефагп 1бапр1еВаке[3] [2]; 


} 
сазе МРЕС 2: 
{ 
5\1есв ( Ваг Мр3З.1Запр1еВахе) 
{ 
сазе 0: 
гтебагп 1бапр1еВаке[2] [0]; 
сазе 1: 
гебагп 1бапр1еВаее[2] [1]; 
сазе 2: 
гебагп 1батр1еКасе[2] [2]; 


} 
сазе МРЕС 25: 
{ 
5\1еср ( Баг _Мр3.1Запр1еКахе) 
{ 
сазе 0: 
гебагп 1бапр1еВабе[1] [0]; 
сазе 1: 
гебагп 1бапр1еВаЕе[1] [1]; 
сазе 2: 
гебагп 1бапр1еВафе[1] [2]; 


} 
гебагп -1; 
} 
роо1 СМр3ЗТрЕо :: ТзРк1уаее () сопз® 
{ 
1Е ( Вах _Мр3З.1Рг1чуабе) 
тебоагп Егае; 
геботп Еа]15е; 
} 
10Е СМр3ЗТрЕо :: СбебМоае () соп5Е 
{ 
зи1Есв ( паг Мр3З.1Моае } 
{ 
сазе 0: 
гебогп ЗТЕВЕО; 
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сазе 1: 

тебагп ЗОТМТ_$ТЕВЕО; 
сазе 2: 

гееатгп ООАГ СНАММЕТ; 
сазе 3: 


гебагп $1МСЬЕ_СНАММЕГ; 
} 
гебагп -1; 
} 
Боо1 СМр3ЗТрЕо :: Т5Соруг1аве (} сопзЕ 
{ 
1Е ( паг Мр3.1Сору) 
тебагп &гоае; 
геботп Еа15е; 
} 
6001 СМр3ЗТлЕо :: 15$0х191па1(} сопзЕ 
{ 
1Е ( Баг МрЗ.10г191па1) 
гебагп &гие; 
геготп Еа15е; 
} 
ОМОВО СМр3ЗТпЕо :: Сеф512е () сопз® 
{ 
хебогп Вах _Мр3З.9м512е; 
} 
уо1А СМр3ЗТпЕо :: СеЕТ1Е1е ( сваг* раЕЁег) соп$Е 
{ 
зЕгсру { БаЕЕег, $2Т11е); 
} 
У014А СМр3ЗТрЕо :; СефАгЕ1$6 ( свВаг* РоЕЁЕег) сопзЕ 
{ 
$Еусру { БаЕЕег, $2АгЕ15$%); 
} 
уо1а СМр3ЗТрЕо :: СекА1Юит ( спаг* БаЕЁег) сопз® 
{ 
зЕгсру ( БаЕЁЕег, з2А1Ром); 
} 
уо1Аа СМр3ЗТрЕо :: Себуеаг ( сваг* роЕЁег) сопз® 
{ 
$Егсру ( БаЕЁЕег, з2Уеаг); 
} 
%014 СМр3ЗТрЁЕо :: СеЕсСопмепе ( сваг* БоаЁЁЕег) соп5® 
{ 


зЕгсру ( роЁЕЁЕег, $2Соптепе); 
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у01а СМр3ЗТпЕо :: Секбепге ( сваг* рРаЕЕег} сопзЕ 
{ 
1Е ( м 1Сепге > СЕМВЕ$ СОЧМТ) 
$Егсру ( БаЕЁЕег, "ОрКкромт"); 
е15е 
5Егсру ( БаЕЁЕег, бепгез[м 1Сепге]); 
} 
уо1а СМр3ЗТпЕо :: беЕТ1&1е ( сраг* р$2Т11е) 
{. 
1Е {( з6:у1еп ( р$2Т1&1е)} > 30) гебагп; 
5Еутсру ( 52Т1Е1е, рз7Т11е); 
} 
уо1А СМрЗТпЕо ;: беБАг&1$е ( сраг* рз2Аг& 15%) 
{ 
1Е ( 56г1ер { р52Аг®1$%) > 30) гебагп; 
$Егсру ( $2АгЕ15Е, рз2Аг®к15(); 
} 
У0о1а СМр3ЗТпЕо :: ЗееА1Бам ({ сваг* р52А1ит) 
{ 
1Е ( з6г1еп { рз2А1рим) > 30) гебоагп; 
5Егсру ( $52А1Рит, рз2А1ит); 
} 
уо1а СМр3ЗТпЕо :: ЗебУеаг ( сВаг* рз2Уеаг) 
{ 
1Е ( эбе1еп ( рз2Уеаг) > 4) гебагп; 
5Егсру ( 52Уеаг, рэзгуеаг); 
} 
$014 СМр3ЗТпЕо :: ЗееСорпиепте ( сраг* рз2Соптепе) 
{ 
1Е ( э&г1еп ( рз=Соптер®) > 30) гебагп; 
5Егсру ( 52Сопиеп®, рэз2Сопщепе); 
} 
%014 СМр3ЗТпЕо :: Зеббепге ( 116 1Сепге) 
{ 
1Е ( ( 1бепге < 0) && ( 1Сепге > СЕМВЕЗ СООМТ)) гебогп; 
м 1Сепге = 1бепге; 
} 
у019 СМр3ЗТпЕо :: Зауче ( сраг* $2МрЗЕШе) 
{ 
1Е ( $2Мр3ЗЕ11е[0] != '\0') гебоаги; 
// открываем файл для записи 
НАМОГЕ ВЕ11е = МЫ; 
СВаг з72Тетр [30]; 
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ОИОВО ЧмУг1феВукез = 0; 

ВЕ!1е = Сгеакег11е ( 52Мр3Е11е, СЕМЕВТС ИВТТЕ, ЕТЬЕ ЗНАВЕ МВАТТЕ, МОШ,, 
ОРЕМ ЕХТЗТТМС, ЕТЬЕ АТТВТВОТЕ_МОВМАТ, 0); 

// устанавливаем позицию для записи в файл 

ЗесЕ11еРозеег ( ВЕ11е, -128, 0, ЕТЬЕ ЕМО); 

// записываем информационный указатель 

ЗЕгсру ( $2ВаЕЕег, "ТАС\0"); 

Иг1<ег11е ( ЬЕ11е, $2Тетр, 3, & ЧМ\г1ееВукез, МО); 

// название композиции 

И] сеЕ11е ( ВЕ1]е, $2Т1%]е, 30, &аи\г1беВукез, №0); 

// имя испольнителя 

\т15еЕ11е( БЕ11е, $27Аг$15е, 30, &ОмМг1ееВукез, МИГ); 

// название альбома 

\т15еЕ11е ( ЬЕ11е, 32А1рим, 30, &ЧмМг1еВувез, №10); 

// год выпуска 

Ит16ег11е ( ЦЕ1]е, з2Уеаг, 4, &ЧмМг1$еВуеез, МО); 

// комментарии 

Иу1сеЕ11е ( ЮЕ11е, 57Соптеп®, 30, &ЧиМт1сеВувез, МОП); 

// стиль музыки 

37Тепр [0] = ( сВаг) м 1бепге; 

32Тепр [1] = '\0'; 

Ит16ег11е ( ВЕ1]е, 327Тетр, 1, &ЧмМг1$еВуеез, МО); 

// закрываем файл 

С1озеНапа1е { №Е11е); 


Использование класса СМрзтоЕо не должно вызвать никаких вопросов. Вна- 
чале объявляете его в своей программе, а далее вызываете функцию ореп. 
После того как файл МРЗ будет открыт, можно пользоваться остальными 
функциями. Перед тем как сохранить файл с помощью 5ауе, необходимо 
заполнить информационные поля, вызывая поочередно соответствующие 
функции. 

На этом я хотел бы завершить данную главу. Многие интересные темы ос- 


тались "за бортом", но и представленная здесь информация поможет вам 
быстрее разобраться с программированием звука в УЛадо\5. 


ГЛАВА 8 


Системный динамик 


Системный динамик является таким же древним устройством, как и сам 
Х86-совместимый компьютер. Он представляет собой маленький динамик, 
расположенный в системном корпусе, и несколько дополнительных элек- 
тронных компонентов на материнской плате. В прошлом веке, когда не бы- 
ло звуковых плат, именно системный динамик или, как его еще называют, 
спикер выполнял основные функции по извлечению звуков. Большинство 
старых игрушек под ОО$ использовали спикер для озвучивания различных 
игровых ситуаций: от стрельбы до звуков летящего самолета. К. сожалению, 
качество звука оставляло желать лучшего. Потом появились отдельные уст- 
ройства для воспроизведения звука, и спикер перестали применять в игро- 
вых и мультимедийных программах. Однако и по сей день на подавляющем 
большинстве компьютерных систем установлен маленький круглый дина- 
мик. При каждой загрузке компьютера раздается одиночный звуковой сиг- 
нал, подтверждающий успешное тестирование оборудования и выполнение 
операции начальной загрузки (РОЗТ). Для этого используется именно спи- 
кер, поскольку ни звуковая карта, ни любое другое устройство еще не мо- 
жет полноценно функционировать. Разработана целая комбинация различ- 
ных звуковых кодов, позволяющих выявить сбои в подключенном оборудо- 
вании. Именно поэтому системный динамик установлен как в 486-м 
простеньком компьютере, так и в современном мультимедийном "монстре" 
на базе Репиит 4. Вы можете спросить, а зачем нужен спикер в операцион- 
ных системах \У/Мт9о\$, если там есть нормальная звуковая плата. Ответ 
очень прост: системный динамик гарантированно установлен на большин- 
стве компьютеров и его можно применять для вывода системных сообще- 
ний и простых звуковых эффектов. Это, несомненно, даст вашей программе 
преимущество по сравнению с другими. В любом случае, вам самим решать, 
стоит ли использовать возможности системного динамика или нет, а я про- 
сто познакомлю вас с основными методами программирования спикера. 
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8.1. Программирование системного динамика 


Для доступа к системному динамику используется порт с номером 1ъ. Он 
имеет размер 8 бит, но для управления спикером применяются только два 
младщих бита (0 и 1): нулевой бит управляет включением канала 2 систем- 
ного таймера, а первый бит включает динамик. Программирование систем- 
ного таймера рассматривается в гл. 10. Установка этих битов в 1 позволяет 
включить динамик, а сброс — выключить. Рассмотрим пример для включе- 
ния спикера (листинг 8.1). 





: Листинг 8.1. Включение системного динамика 


бреаКег_ Оп ргос пеаг 

разв АХ ; сохраняем значение АХ 

11 АБ, 611 ; читаем состояние порта 

ог АБ, 000000116; устанавливаем биты Ои1в1 
опЕ 6110, А.Ш ; включаем системный динамик 

рор АХ ; восстанавливаем АХ 

гее 

бреаКег Оп епар 


Для выключения спикера можно применить код, представленный в листин- 
ге 8.2. 


: Листинг 8.2. Выключение системного динамика 








бреаКег ОЕЁ ргос пеаг 


разв АХ ; сохраняем значение АХ 

1 АБ, 61 ; читаем состояние порта 

апа АТ, 111111006; устанавливаем биты Ои1в0 
обе 611, АБ ; включаем системный динамик 
рор АХ ; восстанавливаем АХ 

гее 

бреаКег_ОЕЁ епар 

; реализуем работу спикера 

са11 бреаКег Оп; включаем динамик 

; выводим звук примерно 5 секунд 

поу СХ, 0050. ; старшее слово паузы 

ттоу СХ, 083506; младшее слово паузы 

гоу АН, 866 ; функция ВТОб паузы 

1пЕ 156 ; вызываем прерывание 

са11 Зреакег Оп; включаем динамик 
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Аналогичный пример для С+- показан в листинге 8.3. 


: Листинг 8.3. Выключение системного динамика в С++ 


// пишем функцию управления динамиком 
уо1А ЗреаКег ( Боо1 БОп) 


{ 
ОМОВО ОмВезо1е = 0; 
// читаем состояние порта 
1пРоге ( 0х61, &дмВезо]1%, 1); 
1Е ( Бор) // включить динамик 
{ 
ЧчВезо1е |= 0х03; 
// записываем значение в порт 
сасРогЕ ( 0х61, @мВези1е, 1); 
) 
е1зе // выключить динамик 
{ 
ОмВезо]1Е &= ОхЕС; 
соЕРогЕ ( 0ж61, амВеза1е, 1); 
} 
} 


// пишем реализацию работы спикера 

Збреакег ( гие); // включаем динамик 

Че1ау ( 3000); // пауза 3 секунды, можно использовать функцию 51еер 
Зреакег ( ЁЕа1зе); // выключаем динамик 


Рассмотренные функции управляют только включением и выключением 
динамика, сам же выводимый звуковой сигнал не изменяется по частоте. 
Чтобы немного преобразить наш звук, можно сделать так, как показано в 
листинге 8.4. 


поу ВХ, 23286 ; определяем значение частоты 

@зер топе: 

са11 Зреакег Оп ; включаем динамик 

поу СХ, 13881 ; определяем значение для счетчика 
@рачзе: 

1оор @рацзе ; делаем паузу 

са11 ЗреаКег ОЕЁ; выключаем динамик 

поу СХ, 23285 
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@рацзе2: 
]оор @раззе2 ; делаем еще одну паузу 
ес Вх ; уменьшаем значение в ВХ 


Эп2 @зее фопе ; повторяем 


Такой способ изменения частоты имеет серьезный недостаток — большая 
загрузка процессорного времени. Чтобы решить эту проблему, прилется до- 
полнительно программировать порты системного таймера. Я не буду здесь 
рассказывать о работе с таймером (см. гл. 10), а просто приведу пример для 
настройки частоты выводимого звука в герцах (листинг 8.5). 





ера 





Листинг 8.5. Управление частотой звука посредством системного тайм 
бесЕгеадепсе ргос пеаг 

; настраиваем регистр управления системного таймера 

поу АБ, 686 ; канал 2, запись двух байтов, прямоугольные импульсы 
ое 436, АБ ; записываем значение в управляющий порт таймера 

; определяем значение частоты в 440 Гц (1 193 180 / 440) 

шоу АБ, 98 ; младший байт 

оп 425, АБ ; записываем значение в порт динамика 

поу АБ, ОАН ; старший байт 

ое 426, АБ ; записываем значение в порт динамика 

са11 5реаКег Оп; включаем динамик 

; устанавливаем паузу 

поу СХ, 0С350В; определяем значение для счетчика 

@рацзе: 

]оор @рапзе ; делаем паузу 

са11 ЗреаКег ОЕЕ; выключаем динамик 

гее 

ЗееЕхеацепсе епар 


Аналогичный пример для С++ показан в листинге 8.6. 


г в С++ 


// реализуем функцию управления частотой 
уо1а ЗееЕхгеааепсе ( ипз1апея 10е чЕгеаоепсе) 
{ 
ОМОВО ЯмВезо1 = 0; 
1Е ( оЕКхедоаепсе <= 0) гебогп; 
12Е ТрмехСТоск = 1193180; // внутренняя частота таймера 
106 1Уа1ае = 0; // значение делителя частоты 
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// определяем значение делителя 
1Уа1ае = Т1мехС1оск / чЕтеалепсе; 
// настраиваем регистр управления системного таймера 
опЕРоге ( 0х43, 0хВ6, 1); // канал 2, 2 байта, прямоугольные импульсы 
ЯмВези1Е = пО1у149ег % 256; // младший байт делителя частоты 
опЕРОГЕ ( 0х42, ЧмВези1е, 2); // записываем значение в порт динамика 
ЯмКези]6е = п01714ег / 256; // старший байт делителя частоты 
ОПЕРОГЕ ( 0х42, ЧмВези1е, 2); // записываем значение в порт динамика 
} 
// попробуем вывести звуковой сигнал частотой примерно 1000 Гц 
бесЕгедчаепсе ( 1193); // устанавливаем желаемую частоту 
Зреакег ( сгае); // включаем динамик 
$1еер ( 2000); // устанавливаем длительность сигнала равным 2 секунды 
Зреакег ( Еа1зе); // выключаем динамик 


Используя порты таймера для задания частоты, можно воспроизводить лю- 
бые мелодии. Для тех, кто захочет написать иолноценное музыкальное про- 
изведение, приведу значения частот всех нот в табл. 8.1. 


Таблица 8.1. Список частот 


Нота Значение частоты, Гц 
До 4186 
До-диез 4435 
Ре 4699 
Ре-диез 4978 
Ми 5274 
Фа 5588 
Фа-диез 5920 
Соль 6272 
Соль-диез 6645 
Ля 7040 
Ля-диез 7459 
Си 7902 


Как видите, нет ничего сложного в программировании системного динамика. 


ГЛАВА 9 


Часы реального времени 


Каждый компьютер, как минимум, ассоциируется с точностью. А точность, 
так или иначе, подразумевает постоянный отсчет времени. Для реализации 
этой задачи используется специальный модуль, называемый часами реаль- 
ного времени (КТС — Кеа! Тите С1осК). Именно эти часы позволяют нам 
отслеживать дату и время, а компьютеру позволяют упорядочить свою рабо- 
ту, и, кроме того, два раза в год предупреждать нас о переводе стрелок ча- 
сов вперед или назад. Но, как вы заметили, компьютер при необходимости 
выключается, а после включения все временные (и не только) параметры 
восстанавливаются в соответствии с текущим временем. Для этого в модуле 
ВТС имеется небольшая микросхема памяти размером от 64 до 128 байт, 
выполненная ио специальной технологии СМО$. Эта микросхема потребля- 
ет очень мало энергии (в качестве источника используется литиевая бата- 
рейка) и может годами сохранять постоянные значения. Поэтому сюда за- 
писывается различная системная информация, в том числе и время. После 
включения компьютера операционная система считывает данные из СМО$ 
и в соответствии с ними настраивает текущие значения даты и времени. 


Не буду вдаваться в детали, скажу только, что аппаратная организация КТС 
базируется на залающем генераторе синусоидального сигнала с частотой 
32 кГц (точнее 32,768 кГц). Для полпитки применяется высококачественная 
батарейка (ие рекомендует использовать элементы питания фирмы 
Ригасе!) с высокой емкостью заряда (170 мА). Для расчета времени разряда 
можно емкость батарейки разделить на среднее значение тока разряда 
(5 мкА), и мы получим значение времени, измеряемое в часах (34,000 часов 
или 3,88 года). Поскольку точность часов реального времени напрямую за- 
висит от напряжения питания, следует периодически (раз в год) проверять 
параметры батарейки и при необходимости делать замену. Конечно, для 
домашних компьютеров небольшая потеря точности часов не принесет ни- 
каких проблем, но для производственных систем с компьютерным управле- 
нием, а тем более работающих в режиме реального времени, любая неточ- 
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ность системных часов может привести к сбою всего технологического про- 
цесса. 


Для программирования часов реального времени можно воспользоваться 
двумя способами: 


1. С помощью функций В!О$. 
2. С помошью портов ввода-вывода. 
Разберем каждый вариант подробнее. 


9.1. Использование функций ВЮ$ 


Для поддержки ВТС применяется прерывание 1пе 1АБ и несколько функ- 
ций. Эти функции позволяют считывать и устанавливать значения даты и 
времени для памяти СМО5$. Прежде чем перейти к их описанию, я хотел бы 
предоставить вашему вниманию структуру данных в СМО5. Несмотря на 
полный размер памяти (от 64 до 128 байт), стандартизированы только пер- 
вые 51 байт. Остальные зависят от производителя материнской платы и 
здесь рассматриваться не будут. Каждое смещение байта в памяти СМО$ 
определяет номер регистра, через который можно считывать и записывать 
информацию. Для КТС выделены первые 13 регистров, а остальные служат 
для других целей. Формат микросхемы памяти представлен в табл. 9.1. 


Таблица 9.1. Формат памяти СМО$ 





Адрес 


Описание 
регистра 

00ь Текущее значение секунды (00—59 в формате ВСО или 00н—звв) 

01ь Значение секунд будильника (005—59. в формате ВСО или 00»—звв) 

02В Текущее значение минуты (001-—59. в формате ВСО или 00н—звв) 

03в Значение минут будильника (00—59 в формате ВСО или 00,—звв) 

04в Текущее значение часа: 24-часовой режим (00—23. в формате ВСО 
или 005—175), 12-часовой режим АМ (01—12. в формате ВСО или 
00н-—0сь), 12-часовой режим РМ (81:—92в в формате ВСО или в1.—8сь) 

05В Значение часа будильника: 24-часовой режим (005—235 в формате ВСО 
или 00.—171), 12-часовой режим АМ (01—12. в формате ВСО или 
00т-—0сн}, 12-часовой режим РМ (81—92. в формате ВСО или в1.-—8св) 

068 Текущее значение дня недели (01.—07ь в формате ВСО или 01:— отв, 
где о1ь соответствует воскресенью) 

07в Текущее значение дня месяца (01—31 в формате ВСР или 015—1 Ев) 


08 в Текущее значение месяца (01—12 в формате ВСО или 01.—0св) 
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Таблица 9.1 (продолжение) 


Адрес Описание 
регистра 


09 Текущее значение года (00—99п в формате ВСО или 005—63ъ) 


ОАВ Регистр состояния А: бит 7 — обновление времени (1 — идет обновление 
времени, 0 — доступ разрешен), биты 4—6 — делитель частоты (0105 — 
32,768 кГц), биты 0—3 — значение пересчета частоты (01105 — 1024 Гц) 


ОВЬ Регистр состояния В: бит 7 — запрещение обновления часов (1 — идет 
установка, 0 — обновление разрешено), бит 6 — разрешение периоди- 
ческого прерывания тво8 (1 — разрешено, 0 — запрещено), бит 5 — раз- 
решение прерывания от будильника (1 — разрешено, 0 — запрещено), 
бит 4 — вызов прерывания после цикла обновления (1 — разрешено, 0 — 
запрещено), бит 3 — разрешение генерации прямоугольных импульсов 
(1 — разрешено, 0 — запрещено}, бит 2 — выбор формата представле- 
ния даты и времени (1 — двоичный, 0 — ВСО), бит 1 — выбор часового 
режима (1 — 24 часа, 0 — 12 часов), бит 0 — автоматический переход на 
летнее время (1 — разрешено, 0 — запрещено) 


св Регистр состояния С (только для чтения): бит 7 — признак выполненного 
прерывания (1 — произошло, 0 — не было), бит 6 — периодическое пре- 
рывание (1— есть, О— нет), бит 5— прерывание от будильника 
(1 — есть, О — нет), бит 4 — прерывание после обновления часов (1 — 
есть, 0 — нет), биты 0--3 зарезервированы и должны быть равны 0 


ов Регистр состояния Г: бит 7 — состояние батареи и памяти (1 — память 
в норме, 0 — батарейка разряжена) 


ЕВ Состояние РОЗТ после загрузки компьютера: бит 7 — сброс часов по 
питанию (1 — нет питания), бит 6 — ошибка контрольной суммы (САТ) 
в СМОЗ памяти (1 — ошибка), бит 5 — несоответствие конфигурации 
оборудования (1 — РОЗТ обнаружила ошибки конфигурации), бит 4 — 
ошибка размера памяти (1 — РОЗТ обнаружила несоответствие разме- 
ра памяти с записанным в СМО$), бит 3 — сбой контроллера первого 
жесткого диска (1 — есть сбой), бит 2 — сбой в работе часов ВТС (1 — 
есть сбой), биты 0 и 1 зарезервированы и должны быть равны 0 


ЕВ Состояние компьютера перед последней загрузкой: 00в — был выполнен 
сброс по питанию (кнопка Незей или <С>+<АН>+<Оер), озвь — ошибка 
тестирования памяти, 04ь — РОЗТ была завершена и система переза- 
гружена, о5в — переход (3щр амога рег) на адрес в 0040ъ:0067в, 07ь — 
ошибка защиты при тестировании, 08ь — ошибка размера памяти 


108 Тип дисковода (0—3 для А и 4—7 для В): 00005 — нет, 0001ь — 360 Кб, 
00106 — 1,2 Мб, 00115 — 720 Кб, 0100 — 1,44 Мб, 01015 — 2,88 Мб 


115 Резерв 


125 Тип жесткого диска (0—3 для О и 4-7 для С): 00006 — нет, 00015— 
11105 — тип дисковода (от 1 до 14), 11115 — диск первый описывается 
в регистре 19эъ, а диск второй — в 1Ав 
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Адрес 


регистра 
13ь 


14в 


155 
165 
17 
18 
19 
ТАБ 
1в8— 205 
2ЕВ 
ЕВ 
Зов 


318 
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Таблица 9.1 (окончание) 


Описание 


Резерв 


Состояние оборудования: биты 6—7 — число флоппи-дисководов (005 — 
один, 015 — два), биты 4—5 — тип дисплея (005 — ЕСА или \СА, о1ь— 
цветной 40х25, 106 — цветной 80х25, 115 — монохромный 80 х 25), 
биты 2 и 3 зарезервированы, бит 1 — наличие сопроцессора (1 — есть), 
бит 0 — наличие флоппи-дисковода (1 — есть) 


Младший байт размера основной памяти в килобайтах (808) 
Старший байт размера основной памяти в килобайтах (028) 
Младший байт размера дополнительной памяти в килобайтах 
Старший байт размера дополнительной памяти в килобайтах 
Тип первого жесткого диска 

Тип второго жесткого диска 

Резерв 

Старший байт контрольной суммы регистров СМОЗ (105—250) 
Младший байт контрольной суммы регистров СМОЗ (10—20) 
Младший байт размера дополнительной памяти в килобайтах 
Старший байт размера дополнительной памяти в килобайтах 
Значение века в формате ВСО 


Дополнительный флаг свойств: бит 7 — размер памяти (1 — больше 
1 Мб, О — до 1 Мб), бит 6 — используется программой установки, биты 
0—5 зарезервированы 


Зависят от производителя 


Используемый формат представления данных ВСО (Втагу Со4еа Оесита!) 
представляет собой двоично-десятичный код, где каждый байт содержит два 
независимых значения. Первое из них кодируется битами 7—4, а второе — 
битами 3—0. Поддерживаются только положительные значения до 99 вклю- 


чительно. 


А теперь рассмотрим функции В!Ю$ для управления часами реального вре- 


мени. 
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9.1.1. Функция 00Р 


Данная функция позволяет получить текущее значение счетчика КТС. 


Использование: 
1. В регистр Ан следует поместить код функции о00ъ. 


2. Вызвать прерывание 1пе ТА». 


Выход: 

После выполнения функции в регистр дь будет записан код перехода: оон — 
произошел переход времени через полночь. В регистры сх и ох будут запи- 
саны соответственно старшее и младшее значения счетчика. В случае ошиб- 
ки флаг переноса ск будет установлен в 1, иначе сброшен. Поскольку часто- 
та сигнала прерывания составляет 18,2 Гц (18,2 прерываний в секунду), за 
сутки набегает немногим более | 572 480 отсчетов, а после этого счетчик 
сбрасывается в 0. Например, чтобы получить текущее значение счетчика, 
можно использовать код из листинга 9.1. 


: Листинг 9.1. Получение текущего значения счетчика 





; определяем переменную для хранения полученного значения 
Таме Собре аа ? 

; общий код программы 

по АН, 008 ; код функции 008 

106 ТАБ ; вызываем прерывание 

Эс ЕВВОВ НМО ; если произошла ошибка, передаем управление обработчику 
; сохраняем текущее значение счетчика 

цоу мога рег Те Соул, ОХ; младшее слово 

поу мога рег Те СочпЕ + 2, СХ; младшее слово 


9.1.2. Функция 018 


Функция позволяет установить новое значение счетчика для системного 
таймера. 


Использование: 

1. В регистр Ан следует поместить код функции 015. 

2. В регистр сх следует записать старшее слово значения счетчика. 
3. В регистр ох следует записать младшее слово значения счетчика. 
4. Вызвать прерывание 1пе 12». 


Выход: 
В случае ошибки флаг переноса ск будет установлен в 1, иначе сброшен. 
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9.1.3. Функция 021 


Эта функция позволяет получить текущее значение времени в формате 
ВС. 


Использование: 
1. В регистр дн следует поместить код функции о2ь. 


2. Вызвать прерывание 1пе 1АВ. 


Выход: 


В случае ошибки флаг переноса се будет установлен в 1, иначе сброшен. 
При успешном выполнении функции в регистры будут записаны следующие 
значения: сн — значение часа, съ — значение минуты, рн — значение секун- 
ды, рт — значение перехода на летнее время (1 — есть переход, 0 — нет). 
Посмотрите в листинге 9.2, как можно получить текущее время в формате 
ВСО. 


Листинг 9.2. Получение текущего времени в формате ВСВ 








; определяем переменные для хранения полученных значений 

СагкепЕ Нойг © ? 

Сохгепе Млпабе а ? 

СагкепЕ бесопа ар ? 

; общий код программы 

шоу АН, 026 ; код функции 026 

116 ТАБ ; вызываем прерывание 

с ЕВВОК НМО ; если произошла ошибка, передаем управление обработчику 





; сохраняем текущее значение времени 
шоу Русе рег Сакгепе Ноцк, СН; часы 
шоу Бубе рёхг Сагхепе М1пафе, СТ; минуты 
шоу Рубе рег СаггепЕ 5бесопа, ПН; секунды 


9.1.4. Функция ОЗВ 


Функция позволяет установить текущее значение времени в формате ВСО. 
Использование: 

В регистр Ан следует поместить код функции озь. 

В регистр сн следует записать часы. 

В регистр ст, следует записать минуты. 

В регистр рн следует записать секунды. 

В регистр рь нужно поместить значение перехода на летнее время. 


мо - 


Вызвать прерывание 1пе 1Аь. 
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Выход: 


В случае ошибки флаг переноса се будет установлен в 1, иначе сброшен. 
Пример для установки нового системного времени приведен в листинге 9.3. 


поУу СН, 118 ; 11 часов 

поу СЪ, 156 ; 15 минут 

пох ОН, ЗОВ ; 30 секунд 

пох ОГ, 1 ; с переходом на летнее время 

поу АН, 038 ; код функции 038 

11Е 1АБ ; вызываем прерывание 

с ЕВВОК_НМО ; если произошла ошибка, передаем управление обработчику 


9.1.5. Функция 048 


Эта функция позволяет получить текущую дату в формате ВСО. 


Использование: 
1. В регистр Ан следует поместить код функции о4н. 


2. Вызвать прерывание 1пЕ 1АВ. 


Выход: 


В случае ошибки флаг переноса се будет установлен в 1, иначе сброшен. 
При успешном выполнении функции в регистры будут записаны следующие 
значения: сн — значение века, ст, — значение года, он — значение месяца, 
от, — значение дня. Например, для получения текушей даты можно исполь- 
зовать код, представленный в листинге 9.4. 





Листинг 9.4. Получение текущей даты в формате ВСВ 


; определяем переменные для хранения полученных значений 

СоггепЕ Уек а ? 

Сиггепе Уеаг @ ? 

СиггепЕ МопЕй а6 ? 

Сиггепе Рау а ? 

; общий код программы 

пох АН, 048 ; код функции 046 

11Е 1АВ ; вызываем прерывание 

)с ЕВВОВ НМО ; если произошла ошибка, передаем управление обработчику 





; сохраняем текущее значение даты 
по\у Русе рег Сиггкепе Уек, СН; век 
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по\у Бубе рег Сиггепе Уеаг, СЦ; год 
поу Бубе рег Сиггепе МопЕей, ОН; месяц 
пот Бузе рег Сигкепе ПБау, ОН; день 


9.1.6. Функция 05В 


Данная функция позволяет установить текущую дату в формате ВС. 
Использование: 

В регистр дн следует поместить код функции 055. 

В регистр сн следует записать век. 

В регистр ст, следует записать год. 

В регистр он следует записать месяц. 


В регистр от нужно поместить значение дня. 


лмвьъфъ- 


Вызвать прерывание 11 1АЬ. 


Выход: 
В случае ошибки флаг переноса сг будет установлен в 1, иначе сброшен. 


9.1.7. Функция 06Р 


Функция позволяет установить время срабатывания для будильника. 


Использование: 
. В регистр Ан следует поместить код функции 061. 


В регистр сн следует записать часы. 


1 
2 
3. В регистр сь следует записать минуты. 
4. В регистр он следует записать секунды. 
5 


Вызвать прерывание 11 ТАБ. 


Выход: 
В случае ошибки флаг переноса се будет установлен в 1, иначе сброшен. 


9.1.8. Функция 07В 


Эта функция позволяет выключить будильник. 


Использование: 
1. В регистр дн следует поместить код функции отн. 


2. Вызвать прерывание 1пЕ 1Ав. 
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Выход: 

В случае ошибки флаг переноса ск будет установлен в 1, иначе сброшен. 
При успешном выполнении в регистр Ат будет записано значение регистра 
СМО$5 по адресу овв. 


9.2. Использование портов 


Для доступа к часам реального времени используются всего два порта: 701 и 
71н. Порт 706 используется только для записи и позволяет выбрать адрес 
регистра в СМОЗ памяти. Порт 71ъ применяется как для записи, так и для 
чтения данных из указанного (через порт 70%) регистра СМО$. Оба порта 
являются 8-разрядными. Кроме того, бит 7 в порту 705 не относится к рабо- 
те с ВТС, а управляет режимом немаскируемых прерываний (1 — прерыва- 
НИЯ запрещены). Если у вас будут проблемы с доступом к регистрам СМО$З, 
следует запрешать прерывания (команда с11) перед началом работы и раз- 
решать прерывания (команда з%1) после. Но, как правило, этого не требует- 
ся. Пример получения числа установленных флоппи-дисководов показан 
в листинге 9.5. 


поу АБ, 14. ; регистр СМО$ 14В 
обе 70р, АЁШ ; записываем значение в порт 


Эр $ +2 ; делаем небольшую паузу 

11 АБ, 71 ; читаем значение регистра 

сезЕ АГ, 0 ; проверяем наличие дисковода в системе 
2 М№ ЕО ; дисководов нет 


апа Аг, ОСОй ; выделяем значение в битах би 7 
зрх АБ, 6 ; получаем результат 
; сохраняем количество дисководов в переменную 





стр АГ, 0 ; один дисковод 

пе @да1ее 

пох Бубе рек МОМ ЕО, 1 

@За1ее: 

стр АЦ, 01 ; два дисковода 

Эпе ЕВВОВ_НМО; не удалось определить число дисководов 
поу Бубе рег МОМ ЕОБ, 2 


Аналогичный пример для`'С++ показан в листинге 9.6. 





// напишем функцию для определения числа флоппи-дисководов 
10 бсееМамЕоо () 
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ОМОВО ЧмВези1% = 0; 
// записываем значение регистра СМО$ 14й в порт 
опЕРогЕ ( 0х70, 0х14, 1); 
// делаем небольшую паузу 
51еер (1); 
// читаем значение из порта 71 
ЗпРоке ( 0х71, &амВези1е, 1); 
// проверяем наличие дисковода в системе 
3Е ( ( ЧмВеза16 & 0х01) == 0х00) гебохр 0; 
// выделяем значение в битах би 7 
ЧМмВези1Е &= 0х0С; 
ЯмВези1Е = ОФмВези1 >> 6; // выделяем результат 
// проверяем 
зм1еср ( 9мВезо1{) 
{ 
сазе 0: 
гебагп 1; // один флоппи-дисковод 
сазе 1: 
гебигп 2; // два флоппи-дисковода 
} 


гебагп 0; 


Таким же способом можно получить или записать любое значение в регист- 
ры СМО$. Давайте попробуем выполнить очистку памяти СМО5. Хотя эта 
операция и позволяет осуществить программный сброс памяти, использо- 
вать ее стоит очень осторожно. Желательно, чтобы на материнской плате 
были установлены две микросхемы СМО$. Причина в том, что на старых и 
некачественных платах затирание ячеек памяти может привести к полному 
отказу начальной загрузки компьютера. Это может быть связано и с изно- 
шенностью микросхемы, и с плохим качеством исполнения, а может зави- 
сеть от батарейки. На современных качественных платах таких проблем, как 
правило, не возникает, но возможность нарушения работы системы все 
равно существует. Исходя из этого, я приведу пример очистки памяти 
СМО$, но ответственность за любые проблемы будет лежать целиком на 
вас. Итак, рассмотрим следующий пример, показанный в листинге 9.7. 





С1еаг СМО$ ргос пеаг 
хог СХ, СХ ; обнуляем регистр СХ 
пох СЬ, ЗЕ ; предполагаем, что размер СМОЗ равен 64 байта 
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@гереае: 

поу АБ, СЁ ; передаем номер регистра СМО$ 

сое 701, АЪ ; записываем значение в порт 

пор ; делаем небольшую паузу 

опЕ 716, АБ ; записываем значение в порт 

1оор @гереае ; повторяем для следующего регистра 
С1еаг_ СМОЗ епар 


Для очистки памяти СМО$ в С+- используйте код из листинга 9.8. 


‚Листинг 9. 8. Очистка памяти смо$ в ‚С++ 


// напишем функцию для очистки СМО$ 
У01А С1еахг СМОЗ ( ипз19пеЯ 106 9517еСмо5) 
{ 
1Е ( 0517еСмо$ < 64) гевогп; 
ог ( Е 1 = 0; 1 < 0512еСмМО$; 1++) 
{ 
оцЕРогЕ ( 0х70, 1, 1); // записываем номер регистра в СМО$ 
опЕРогЕ ( 0х71, 1, 1); // записываем значение в регистр 


} 
// воспользуемся нашей функцией для очистки памяти СМО$ размером 64 байта 


С1еак СМО$ ( 64); 


И напоследок я хочу привести примеры функций для С++, позволяющие 
писать (листинг 9.9) и читать (листинг 9.10) память СМО$ в файл. 


| Листинг 9. 9. "Сохранение п памяти и СМОЗ в в ‚ файл. 





// пишем функцию сохранения СМОЗ в файл 
Боо1 бауе СМОЗ$ ( сВаг* Е11еМаше} 
{ 
ЕТЬЕ* о06Е11е; 
ОМОВО амВезо1е = 0; 
ВУТЕ БаЕЁЕеу [64]; 
// открываем новый файл 
1Е ( ( ос6Е1]е = ЁРореп ( Е11еМаме, "мю")) == МО.) 
гефкигп Еа1зе; // не удалось создать файл 
ох ( Шт = О; 1 < 64; 1++) 
{ 
опЕРохеЕ ( 0х70, 1, 1); // записываем номер регистра в СМО$ 
$1еер (1); // пауза 
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1пРогЕ ( 0х71, &амВезо1е, 1); // читаем байт из СМО$ 
БоЕЕег[1] = амВезо1; 

} 

// записываем данные в файл 

Еигтее ( БоЁЁЕех, 1, 64, одЕЕ11е); 

// закрываем файл 

Ес}озе( оцЕЕ11е); 

гебагл &тхое; 





| Листинг 3. 10. Загрузка памяти и СМОЗ и из з файла. 


// пишем функцию загрузки СМО$ из файла 
Боо1 .оаа СМО$ ( сНахг* Е11еМапе) 
{ 
ЕТЬЕ* арЕе; 
ОМОВО ЧмВезо1* = 0; 
ВУТЕ БаЕЕехг [64]; 
// открываем новый файл 
ЗЕ ( (поЕЫе = Еореп ( Е11еМаще, "\")) == МОШ,) 
тебиго Еа13е; // не удалось создать файл 
// читаем файл в буфер 
Егеаа( БоаЁЕег, 1, 64, 10Е1]1е); 
// закрываем файл 
Ес]1озе( 10Е11е}; 
// сохраняем данные в СМОб 
Еог (т =О0; 1 < 64; 1++) 
{ 
ЧмВези16 = БаЕЕех [1]; 
оцЕРокЕ ( 0х70, 1, 1); // записываем номер регистра в СМО$ 
осЕРохЕ ( 0х71, АмВезо1е, 1); // записываем значение в регистр 
} 


гебоахп Ехое; 


На этом можно завершить программирование часов реального времени и 
памяти СМО$. 


ГЛАВА 10 


Таймер 


В любом компьютере наряду с часами реального времени существует уст- 
ройство системного таймера, для реализации которого применяется спенпи- 
альная микросхема (например, 8254). Он помогает организовать всевозмож- 
ные временные задержки, счетчики и управляющие сигналы. Из всех пре- 
доставляемых таймером функций, можно выделить несколько основных: 


1. Организация часов реального времени. 


2. Программируемый генератор прямоугольных и синусоидальных им- 
пУлЬсов. 


3. Счетчик событий таймера. 
4. Управление двигателями флоппи-дисководов. 


Таймер предоставляет три независимых канала, каждый из которых имеет 
свое назначение. В первом канале (0) отслеживается текущее значение вре- 
мени от момента включения компьютера, для хранения которого использу- 
ется область памяти В1О$ (0040:006С). Каждое изменение значения (18,2 раз 
в секунду) в этом канале генерирует прерывание твоо (1п 81). Данное пре- 
рывание будет обработано процессором в первую очередь, но при этом 
должны быть разрешены аппаратные прерывания. При программировании 
первого канала всегда следует после выполнения задачи восстанавливать его 
первоначальное состояние. Второй канал (1} используется системой для ра- 
боты с контроллером прямого доступа к памяти (ОМА). Третий канал (2) 
позволяет управлять системным динамиком. 


Генератор сигналов таймера вырабатывает импульсы с частотой 1 193 180 Гц. 
Поскольку максимальное значение 16-битного регистра ограничено значе- 
нием 65 535, используется делитель частоты. В итоге, результирующее зна- 
чение равно 18,2 Ги. Именно с такой частотой выдается прерывание твоо. 


Для работы с системным таймером используются порты от 408 до 43ъ. Все 
они имеют размер 8 бит. Порты с номерами 408, 41. и 42. связаны соответ- 
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ственно с первым, вторым и третьим каналами, а порт 4зь работает с управ- 
ляющим регистром таймера. Принцип работы с портами очень простой: 
в порт 4зь записывается управляющая команда, а после этого данные запи- 
сываются или считываются из 40н, 41ни 425, в зависимости от решаемой 
задачи. Формат командного регистра представлен в табл. 10.1. 


Таблица 10.1. Формат управляющего регистра таймера 


СИ ОС СО Е ЕКВ 


Приведем краткое описание табл. 10.1. 















Описание 


О Бит 0 определяет формат представления данных: 0 — двоичный (16-бит- 
ное значение от 00005 до ЕЕЕЕН), | — двоично-десятичный (ВСО от 0000 
до 9999). 


С Биты 1—3 определяют режим работы таймера. Существуют шесть режи- 
мов работы (от 0 до 5). Возможные значения перечислены в табл. 10.2. 


С Биты 4—5 определяют тип операции. Имеются четыре возможных значе- 
ния, которые перечислены в табл. 10.3. 


С Биты 6—7 позволяют выбрать номер канала или управляющий регистр 
(только для операций чтения). Возможные значения этого поля перечис- 
лены в табл. 10.4. 


Таблица 10.2. Режимы работы таймера 


Бит3 Бит1 | Описание режима 


0 0 Генерация прерывания твоо при установке счетчика в 0 
Установка в режим ждущего мультивибратора 

Установка в режим генератора импульсов 

Установка в режим генератора прямоугольных импульсов 


Установка в режим программно-зависимого одновибратора 





ооо 


Установка в режим аппаратно-зависимого одновибратора 


Таблица 10.3. Тип операции 


Тип операции 
0 


Команда блокировки счетчика 


Чтение/запись только младшего байта 
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Таблица 10.3 (окончание) 







Чтение/запись только старшего байта 


Чтение/запись младшего, а за ним старшего байта 


Таблица 10.4. Возможные значения для поля 6-7 












Выбор первого канала (0) 
Выбор второго канала (1) 
Выбор третьего канала (2) 


Команда считывания значений из регистров каналов 


При установке битов 6 и 7 управляющего регистра в | будет использована 
команда считывания данных. При этом формат определения этого регистра 
меняется согласно табл. 10.5. 


Таблица 10.5. Формат управляющего регистра в режиме считывания 


О Е ОСИ ОИ 


Приведем краткое описание таблицы. 
















Описание 


С Бит 0 не используется и должен быть установлен в 0. 


С Биты 1—3 позволяют установить номера каналов. Установка бита в | вы- 
бирает соответствующий номер канала. 


СО Бит 4 позволяет получить состояние для выбранного канала (каналов) 
при установке в 0. 


С Бит 5 позволяет зафиксировать значение счетчика для выбранного кана- 
ла (каналов) при установке в 0. 


С Биты би 7 определяют команду чтения и должны быть установлены в |. 


При выполнении команды блокировки счетчика (биты 4 и 5 установлены 
в 0) можно получить значение (состояние) выбранного счетчика без оста- 
новки самого таймера. Результат считывается из указанного канала (биты 6 
и 7). При этом формат команды будет таким, как показано в табл. 10.6. 
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Таблица 10.6. Формат команды блокировки 









Описание Не используются 


Приведем краткий комментарий к таблице. 
О Биты 0—3 не используются и должны игнорироваться. 


О Биты 4 и 5 определяют команду блокировки и должны быть установлены 
в 0. 


С Биты 6 и 7 определяют номер канала (см. табл. 10.4), для которого будет 
выполнена команда блокировки. 


Полученный байт состояния имеет определенный формат (табл. 10.7). 


Таблица 10.7. Формат байта состояния канала 


ПО ИСИ ПЕ ИСЗ ВЕ ПОВЕЗИ ПОЗИВ 


Готов Тип операции Режим работы 









Описание 





Приведем краткое пояснение к таблице 10.7. 


О Бит 0 определяет формат представления данных: 0 — двоичный (16-бит- 
ное значение от 00005 до ЕЕЕЕЪ), | — двоично-десятичный (ВСР от 0000 
до 9999). 


С Биты 1—3 определяют режим работы таймера. Возможные значения пе- 
речислены в табл. 10.2. 


С Биты 4—5 определяют тип операции. Возможные значения перечислены 
в табл. 10.3. 


О Бит 6 определяет готовность счетчика для считывания данных (1 — го- 
тов, 0 — счетчик обнулен). 





С Бит 7 определяет состояние выходного сигнала на канале в момент бло- 
кировки счетчика импульсов. 


Рассмотрим стандартный пример для установки начального значения счет- 
чика для второго канала (управляет динамиком) равным 5 120 Гц (лис- 
тинг 10.1). 


поу АБ, 101101106 ; канал 2, операция 4, режим 3, формат 0 
ое 431, АБ. ; записываем значение в порт 
поу АХ, ОЕЭ ; определяем делитель частоты для получения 5120 Гц 
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ое 422, АБ ; посылаем младший байт делителя 
поУу АБ, АН ; копируем значение 
ойЕ 425, АБ ; посылаем старший байт делителя 


Аналогичный пример для С++ показан в листинге 10.2. 


Листинг 10.2. Установка начального значения счетчика для второго канала 
: в С++ 


// нишем функцию установки значения счетчика 
$901 ЗеЕеСочпЕ ( 1пЕ 101у1аег) 
{ 
116 1Уа1ое = 0; 
оцЕРогЕ ( 0х43, 0хВ6, 1); // канал 2, операция 4, режим 3, формат 0 
1Уа]ае = 101\%14ег & 0хоЕ; 
очЕРОгЕ ( 0х42, 1Уа1ае, 1); // младший байт делителя 
оцЕРохгЕ ( 0х42, ( 101у14ех >> 4), 1); // старший байт делителя 


А теперь рассмотрим пример для получения случайного значения в установ- 
ленном диапазоне (листинг 10.3). 





; выделяем место для переменной 

Вапаот Уа1ще 95 ? 

; сначала пишем процедуру для установки режима работы таймера 
Тамехг1п1Е ргос пеаг 

поу АБ, 10110111 ; канал 2, операция 4, режим 3, формат 1 
опЕ 436, АЁЬ ; записываем значение в порт 

поу АХ, 11931; определяем делитель частоты 

ойЕ 420, АБ ; посылаем младший байт делителя 

по\ АГ, АН ; копируем значение 

ОЕ 421, АЁЬ ; посылаем старший байт делителя 

тее 

Т1мехТп1е епар 

; пишем процедуру получения случайного значения 
СеЕВапаомУа1ие ргос пеаг 

пох АГ, 100000006 ; канал 2, получить значение, биты 3-0 игнорируем 
оф 435, АЁЬ ; записываем значение в порт 

11 АГ, 421 ; читаем младший байт значения счетчика 

поУ АН, АБ ; копируем его в АН 





11 АБ, 422 ; читаем старший байт значения счетчика 
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са11 ТумехТи1Е ; устанавливаем таймер заново 
хсВа АН, АБ ; меняем местами младший и старший байты 
; сохраняем полученное значение в переменную 

шоу Рубе рег Капаом Уа1ае, АХ 

гее 

Се{ВапаомУа1ае епар 


Реализация генератора случайных чисел на С++ представлена в листин- 
ге 10.4. 


// пишем функцию установки таймера 
уо1а Тп1ЕСоипе ( 116 1Махиаам) 
{ 
106 1Уа1]ое = 0; 
1пе 101 = 1193180 / 1Махииом; 
оЧЕРОгЕ ( 0х43, ОхВ7, 1); // канал 2, операция 4, режим 3, формат 1 
1Уа1ае = 101% & ОхоЕ; 
оцЕРогЕ ( 0х42, 1Уа1ще, 1); // младший байт делителя 
ооЕРоге ( 0х42, ( 101у >> 4), 1); // старший байт делителя 
} 
// пишем функцию генерации случайного значения 
1п& беЕВапаомУа]ае ( 116 1Мах1том) 
{ 
ОИОВО 9мЪ$В = 0, 9мМЗВ = 0; 
// канал 2, получить значение, биты 3-0 игнорируем 
очЕРогЕ ( 0х43, 0х80, 1); 
// читаем младший байт значения счетчика 
1пРогЕ ( 0х42, &9мЪ5$В, 1); 
// устанавливаем таймер заново 
Тп1ЕСооре ( 1Махиом); 
// читаем старший байт значения счетчика 
1оРогЕ ( 0х42, &амм$В, 1); 
тебсагп ( 1106) ( ( МОВО) ( ( ( ВУТЕ) ( 9м$в)) | 
( ( ( ИОВО) ( ( ВУТЕ) ( амМ$В))) << 8))); 


На этом можно считать тему программирования системного таймера завер- 
шенной. 


ГЛАВА 11 


Дисковая подсистема 


Каждый день мы садимся за компьютер и выполняем различную работу: 
кто-то заполняет бухгалтерские бланки, кто-то набирает текст, а кто-то ска- 
чивает музыку из Интернета. Что бы вы ни делали, постоянно приходится, 
так или иначе, сохранять результаты своего труда. Для этого используются 
наиболее популярные устройства: жесткий диск, гибкий диск или компакт- 
диск. Поэтому любой серьезный программист должен уметь работать с ни- 
ми, несмотря на постоянное упрощение языков программирования. В этой 
главе мы научимся управлять данными устройствами как минимум тремя 
разными способами: 


1. С использованием функций В1О$. 
2. С использованием портов ввода-вывода. 
3. С помошью интерфейса \УИт32 АРУ. 


Каждый способ имеет свои плюсы и минусы, а также определенную необ- 
ходимость применения в той или иной ситуации. Окончательный выбор бу- 
дет зависеть только от вас. И еще одно важное замечание: неправильное ис- 
пользование функций и других средств доступа к дискам может привести к 
полной или частичной потере информации, а также к поломке самого уст- 
ройства. 


11.1. Использование функций ВЮ$ 


Функции ВОЗ для поддержки дисковой подсистемы можно разделить на 
две группы: стандартные и дополнительные. Первая группа функций рас- 
считана на работу с дисками размером до 528 Мбайт и использует адреса- 
цию в формате СН$ (суйпдег-Неаа-зесбог — цилиндр-головка-сектор). Все 
современные диски используют логическую адресацию, но могут эмулиро- 
вать и СН. С помощью функций В1О5 можно получить прямой доступ к 
структуре носителя, что может потребоваться при разработке специальных 
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дисковых утилит (например, программы для восстановления удаленных 
файлов). Следует помнить, что функции В!О$ работают с физическим уст- 
ройством диска, а не с логическими разделами. Все функции ВТО для ра- 
боты с дисками используют прерывание 1п- 133. Рассмотрим их подробнее. 


11.1.1. Функция 00 


Данная функция предназначена для сброса дискового устройства, которое 
заключается в перекалибровке головок диска и перевода их в исходную по- 
Зицию. 

Использование: 

1. В регистр дн следует поместить код функции оон. 


2. В регистр от следует поместить номер дисковода. Номера жестких дисков 
лежат в диапазоне 80п— ЕН, а гибких — оон—7ЕЪ. Установка бита 7 в 1 
позволит сразу выполнить сброс всех доступных дисководов. 


3. Вызвать прерывание +пе 13. 


Выход: 


После выполнения функции в регистр дн будет помещен код состояния. 
Флаг ск в случае ошибки будет установлен в 1, иначе сброшен. Возможные 
коды ошибок представлены в табл. 11.1. 


Таблица 11.1. Коды состояния 





Код Описание 





00 — Операция успешно завершена 

01п — Недопустимый код функции или значение параметра функции 
02. — Адресный указатель не найден 

03й — Диск защищен от записи 

04 — Ошибка чтения, не найден сектор 

05№ — Сброс устройства не был выполнен (только для жесткого диска) 
06й — Смена диска (только для флоппи-дисковода) 

07. — Ошибка параметра диска (только для жесткого диска) 

08№ Переполнение ОМА 

091 Превышение границы в 64 Кб для ОМА 

АВ — Обнаружен сбойный сектор (только для жесткого диска) 

овы — Обнаружена сбойная дорожка (только для жесткого диска) 


0Сп — Несовместимый тип дорожки или недопустимый носитель 
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ор 


ОЕВ 


В5В 


ВВЫ 
ССВ 
ЕОБ 


РЕП 


Таблица 11.1 (окончание) 


Описание 


Недопустимое количество секторов для указанного формата 


Обнаружен адрес указателя на управляющие данные 
(только для жесткого диска) 


Превышения диапазона для уровня арбитража ОМА 
(только для жесткого диска) 


Ошибка чтения (по коду СВС или ЕСС) 


Ошибка в данных исправлена по коду избыточности ЕСС 
(только для жесткого диска) 


Сбой контроллера 

Отсутствует носитель 

СМО$ содержит неправильный тип установленного дисковода 
Ошибка поиска 

Диск не готов 

Диск не готов (только для жесткого диска) 

Том не заблокирован в дисководе 

Том заблокирован в дисководе 

Том нельзя извлечь из дисковода 

Том в настоящий момент используется 

Превышено значение счетчика блокировок 

Не удалось извлечь носитель 

Том присутствует, но доступен только для чтения 
Неопределенная ошибка (только для жесткого диска) 
Ошибка записи (только для жесткого диска) 

Ошибка в регистре состояния 


Ошибка выполнения операции статуса (только для жесткого диска) 


Рассмотрим простой пример для сброса флоппи-диска, показанный в лис- 
тинге 11.1. 





по\У АН, ООП ; функция сброса 
по\у ОБЬ, 00 ; номер первого дисковода 
11 138 


; вызываем прерывание 
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11.1.2. Функция 01А 


Данная функция предназначена для получения информации о статусе по- 
следней выполненной команды. 

Использование: 

1. В регистр Ан следует поместить код функции 018. 


2. В регистр от следует поместить номер дисковода. Номера жестких дисков 
лежат в диапазоне 8он—РЕЪ, а номера гибких — о0н—7 ЕВ. 


3. Вызвать прерывание 1пе 13в. 


Выход: 


После выполнения функции в регистр Ан будет записан код состояния 
(см. табл. 11.1). Флаг се в случае ошибки будет установлен в |1, иначе сбро- 
шен. В листинге 11.2 показан пример использования этой функции. 





Листинг 11.2. Сброс первого жесткого диска 


; сначала выполним сброс первого жесткого диска 

по АН, ООН ; функция сброса 

шоу ОГ, 801 ; номер первого дисковода 

116 136 ; вызываем прерывание 

; теперь проверим результат операции сброса 

шоу АН, 018 $; функция 018 

поу ОЬ, 805 ; тот же дисковод 

1пЕ 136 ; вызываем прерывание 

3с ЕггогНпЯ ; если произошла ошибка, вызываем обработчик 


11.1.3. Функция 028 


Функция позволяет прочитать один или более секторов с указанного диска 
и поместить в указанное место в памяти. Для РОЗ и болынинства У! и4о\5 
размер сектора равен 512 байт. 


Использование: 
1. В регистр Ан следует поместить код функции о2ь. 


2. В регистр Ат, следует записать количество секторов, которые должны 
быть прочитаны. Это значение не должно быть меньше |.. 


3. В регистр сн записываются младшие 8 битов номера цилиндра. Номер 
цилиндра для жестких дисков имеет размер 10 бит. Два старших бита 
(8 и 9) определяются в регистре ст, (6 и 7 биты). 


4. В регистр ст, записывается номер начального сектора от 1 до 63 (исполь- 
зуются биты 0—5). Для жестких дисков в биты 6 и 7 следует записать 
значения старших битов для номера цилиндра. 
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5. В регистр он нужно записать номер головки. 


6. В регистр рт, следует поместить номер дисковода. Номера жестких дисков 
лежат в диапазоне вон—ЕЕЪ, а гибких — о0н—7ЕВ. 


7. В ез:вх нужно поместить указатель на буфер данных. 
8 Вызвать прерывание 1пе 135. 


Выход: 

После выполнения функции в регистр Ан будет записан код состояния 
(см. табл. 11.1). Флаг сЕ в случае ошибки будет установлен в 1, иначе сбро- 
шен. В регистр Ат, будет записано количество реально прочитанных секто- 
ров. Рассмотрим пример кода для чтения одного сектора с жесткого диска, 
показанный в листинге 11.3. 


; сначала выделим память под буфер 
Чафа_теаа 94 512 ПУР (?) 

; различный общий код 

по АН, 02. ; функция 026 


поу А, 011 ; один сектор 

поу ВХ, ОЕЁзеф Чафа геа@; указатель на буфер 
поу СН, О0В $; номер цилиндра 

поУ СЬ, 00А ; номер начального сектора 


поу ОН, ООВ $; номер головки 

пох ОЪ, 80В $; первый жесткий диск 

11 136 ; вызываем прерывание 

с ЕггогНпа ; если произошла ошибка, вызываем обработчик 


11.1.4. Функция ОЗЛ 


Эта функция предназначена для записи одного или более секторов на ука- 
занный диск. 


Использование: 
1. В регистр Ан следует поместить код функции озъ. 


2. В регистр Ат следует записать количество секторов, которые должны 
быть записаны. Это значение не должно быть меньше 1. 


3. В регистр сн записываются младшие 8 битов номера цилиндра. Номер 
цилиндра для жестких дисков имеет размер 10 бит. Два старших бита 
(Зи 9) определяются в регистре ст (6 и 7 биты). 


4. В регистр съ записываются номер начального сектора от 1 до 63 (исполь- 
зуются биты 0—5). Для жестких дисков в биты 6 и 7 следует записать 
значения старших битов для номера цилиндра. 
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5. В регистр он нужно записать номер Головки. 


6. В регистр рь следует поместить номер дисковода. Номера жестких дисков 
лежат в диапазоне 80н—ЕЕЪ, а номера гибких — 00,—7ЕВ. 


7. В Ез:вх нужно поместить указатель на буфер данных. 
8. Вызвать прерывание 1пе 138. 


Выход: 

После выполнения функции в регистр Ан будет записан код состояния 
(см. табл. 11.1). Флаг се в случае ошибки будет установлен в [, иначе сбро- 
шен. В регистр ат, будет записано количество реально записанных секторов. 
В листинге 11.4 показан пример кода для записи одного сектора на жесткий 


ДИСК. 





сектора на жесткий диск 





; сначала выделим память под буфер 
Чафа_мг1ее аю 512 ПОР (0) 

; различный общий код 

поУ АН, ОЗВ ; функция 038 


поу АБ, 01. ; один сектор 

шоу ВХ, ОЁЁзеЕ дафа мг1ее; указатель на буфер 
шоу СН, ОО ; номер цилиндра 

по\У С, 00В ; номер начального сектора 

по\у ОН, ООВ ; номер головки 

поу ОЪ, 805 ; первый жесткий диск 

11 138 ; вызываем прерывание 


3с ЕггогНрЯ ; если произошла ошибка, вызываем обработчик 


Ни в коем случае не пытайтесь выполнить приведенный выше код! Пример 
показан исключительно для демонстрационных целей. Игнорирование этого 
условия приведет к затиранию загрузочной области вашего жесткого диска и 
невозможности дальнейшей работы. По умолчанию, загрузочный сектор бу- 
дет перезаписан пустыми значениями, и вы потеряете всю информацию! 


11.1.5. Функция 048 


Функция предназначена для проверки записанного сектора или секторов на 
указанном диске. Она позволяет контролировать процесс записи данных 
посредством считывания и проверки контрольной суммы. 

Использование: 

1. В регистр Ан следует поместить код функции о4в. 


2. В регистр АЪ следует записать количество секторов, которые должны 
быть проверены. Это значение не должно быть меньше [. 
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3. В регистр сн записываются младшие 8 битов номера цилиндра. Номер 
цилиндра для жестких дисков имеет размер 10 бит. Два старших бита 
(Зи 9) определяются в регистре ст, (би 7 биты). 


4. В регистр ст, записывается номер начального сектора от 1 ло 63 (исполь- 
зуются биты 0—5). Для жестких дисков в биты 6 и 7 следует записать 
значения старших битов для номера цилиндра. 


5. В регистр он нужно записать номер головки. 


6. В регистр рот следует поместить номер дисковода. Номера жестких дисков 
лежат в диапазоне звов— ЕВ, а гибких — о0н—7ЕВ. 


7. В Ез:вх нужно поместить указатель на буфер данных. 
8. Вызвать прерывание +пЕ 1358, 


Выход: 


После выполнения функции в регистр Ан будет записан код состояния 
(см. табл. 11.1). Флаг сЕ в случае ошибки будет установлен в 1, иначе сбро- 
шен. В регистр Ат, будет записано количество реально проверенных секторов. 


11.1.6. Функция 05Р 


Функция предназначена для форматирования дорожки гибкого диска (лис- 
кеты). Функцию можно использовать только для флоппи-дисководов. 


Использование: 
1. В регистр Ан следует поместить код функцйи о5н. 


В регистр Ат нужно записать количество секторов. 


2 

3. В регистр сн нужно записать номер дорожки. 
4. В регистр он нужно записать номер головки. 
5 


В регистр рЪ следует поместить номер дисковода. Номера гибких дисков 
лежат в диапазоне о0п—7 ЕВ. 


6. В кз:вх нужно поместить указатель на адрес буфера, содержащего список 
полей для форматирования. Размер каждого поля равен 4 байта, а формат 
показан в табл. 11.2. 


7. Вызвать прерывание 1п= 135. 


Выход: 

После выполнения функции в регистр Ан будет записан код состояния 
(см. табл. 11.1). Флаг сЕ в случае ошибки будет установлен в 1, иначе сбро- 
шен. 
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Таблица 11.2. Формат поля 


Смещение Размер Описание 
адреса 
005 Байт Номер дорожки 
018 Байт Номер головки (начиная с 0) 
025 Байт Номер сектора 
Зв Байт Размер сектора (00ъ — 128 байт, о1ь — 256 байт, 


02. — 512 байт, озн — 1024 байта) 


11.1.7. Функция 08 


Эта функция позволяет получить информацию о дисководе. 


Использование: 
1. В регистр дн следует поместить код функции о8в. 


2. В регистр рт, следует поместить номер дисковода. Номера жестких дисков 
лежат в диапазоне 80н—ЕЕЪ, а номера гибких — 005—7ЕЪ. 


3. Вызвать прерывание 1пе 138. 


Выход: 

После выполнения функции в регистр Ан будет записан код состояния 
(см. табл. 11.1). Флаг се в случае ошибки будет установлен в 1, иначе сбро- 
шен. В регистр вт, будет записан тип дисковода (табл. 11.3) для гибких дис- 
ков. В сн будут записаны младшие 8 битов максимального номера цилиндра, 
а в съ — максимальный номер сектора (биты 0—5) и два старших бита 
(би 7) номера цилиндра. В регистр рн будет помещен максимальный номер 
головки, а в рь — общее количество дисководов. Кроме того, для флоппи- 
дисков по адресу кз: рт будет помещен указатель на список параметров. 


Таблица 11.3. Типы дисководов 


Код Описание 
015 360 Кб 
025 1,2 Мб 
зв 720 Кб 
04в 1,44 Мб 


обв 2,88 Мб 


108 Устройство АТАР! с поддержкой сменных носителей 
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Рассмотрим пример для проверки наличия стандартного 3-дюймового дис- 
ковода на гибких дисках, показанный в листинге 11.5. 


Листинг 14.5. Проверка наличия дисковода для гибких дисков 
поу АН, 08 ; функция 088 

ноу РЬ, 006 $; первый дисковод 

10$ 130 ; вызываем прерывание 

)с ЕтгогНоЧ ; если произошла ошибка, вызываем обработчик 


стр ВЬ, 041 ; проверяем тип дисковода 
пе №_144 ; нет такого дисковода по этому адресу 


11.1.8. Функция О9Р 


Функция позволяет инициализировать жесткий диск параметрами по умол- 
чанию. Эта функция не используется для флоппи-дисководов. 


Использование: 
1. В регистр Ан следует поместить код функции о09ъ. 


2. В регистр рь следует поместить номер жесткого диска. Номера жестких 
дисков лежат в диапазоне 80п—ЕЕЬ. 


3. Вызвать прерывание 1п* 135. 


Выход: 


После выполнения функции в регистр Ан будет записан код состояния 
(см. табл. 11.1). Флаг се в случае ошибки будет установлен в 1, иначе сбро- 
шен. 


11.1.9. Функция ОСВ 


Данная функция предназначена для поиска указанного цилиндра и должна 
использоваться только для жестких дисков. 

Использование: 

1. В регистр дн следует поместить код функции осв. 


2. В регистр сн следует записать младшие 8 битов номера цилиндра. Номер 
цилиндра для жестких дисков имеет размер 10 бит. Два старших бита 
(8 и 9) определяются в регистре ст, (биты 6 и 7). 


3. В регистр съ, записывается номер сектора (используются биты 0—5). В би- 
ты би 7 следует записать значения старших битов для номера цилиндра. 


4. В регистр рн нужно поместить номер головки. 
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5. В регистр рт, следует поместить номер жесткого диска. Номера жестких 
дисков лежат в диапазоне 80п—ЕЕВ. 


6. Вызвать прерывание 1пе 131. 


Выход: 


После выполнения функции в регистр Ан будет записан код состояния 
(см. табл. 11.1). Флаг сг в случае ошибки будет установлен в 1, иначе сбро- 
шен. Например, чтобы переместиться на 110-й цилиндр (головка 1, сек- 
тор 1), следует использовать код из листинга 11.6. 


поу АН, ОСА ; функция 0СВ 

иоу СН, 6бЕРр ; цилиндр номер 110 

поу СЬ, 011 ; первый сектор 

поу ОН, 011 ; первая головка 

поу ОЬ, 80А ; первый жесткий диск 

116 138 ; вызываем прерывание 

)с ЕггогНпа ; если произошла ошибка, вызываем обработчик 


11.1.10. Функция ОБР 


Функция позволяет выполнить сброс жесткого диска. Происходит повтор- 
ная инициализация контроллера, установленные параметры сбрасываются, а 
головки устанавливаются в позицию первой дорожки. 


Использование: 
1. В регистр дн следует поместить код функции орь. 


2. В регистр от следует поместить номер жесткого диска. Номера жестких 
дисков лежат в диапазоне 801—ЕЕ\. 


3. Вызвать прерывание 11 13ь. 


Выход: 


После выполнения функции в регистр Ан будет записан код состояния 
(см. табл. 11.1). Флаг сЕ в случае ошибки будет установлен в 1, иначе сбро- 
шен. Например, чтобы выполнить сброс второго жесткого диска, используй- 
те следующий код из листинга 11.7. 





Листинг 11.7. Сброс второго жесткого диска 


поу АН, ОСА ; функция 008 

поу ОЪ, 811 ; второй жесткий диск 

106 135 ; вызываем прерывание 

Эс ЕггогНаа ; если произошла ошибка, вызываем обработчик 
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11.1.11. Функция 101 


Эта функция позволяет проверить готовность жесткого диска к работе. 


Использование: 
1. В регистр дн следует поместить код функции 10. 


2. В регистр рь следует поместить номер жесткого диска. Номера жестких 
дисков лежат в диапазоне 80й—ЕЕ. 


3. Вызвать прерывание 1пЕ 135. 


Выход: 

После выполнения функции в регистр Ан будет записан код состояния 
(см. табл. 11.1). Флаг се в случае ошибки будет установлен в [, иначе сбро- 
шен. Пример использования данной функции показан в листинге 11.8. 


Листинг 11.8. Использование функции 105 


@гереае 

поу АН, 101 ; функция 108 

пох ОЬ, 801 ; первый жесткий диск 
10 135 ; вызываем прерывание 


сир АН, ОААП ; если диск не готов 
Зе @тереаЕ ; повторяем 


11.1.12. Функция 177А 


Данная функция позволяет выполнить рекалибровку жесткого диска. При 
этом контроллер переводит головки в область нулевого цилиндра. 


Использование: 
1. В регистр дн следует поместить код функции 115. 


2. В регистр рт, следует поместить номер жесткого диска. Номера жестких 
дисков лежат в диапазоне 80н—ЕЕЬ. 


3. Вызвать прерывание зп* 13ь. 


Выход: 


После выполнения функции в регистр Ан будет записан код состояния 
(см. табл. 11.1). Флаг ск в случае ошибки будет установлен в 1, иначе сбро- 
шен. Для устранения сбоев выполните рекалибровку второго диска, как по- 
казано в листинге 11.9. 
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шоу АН, 111 ; функция 005 

иоу ОБЬ, 812 ; второй жесткий диск 

12 136 ; вызываем прерывание 

)с ЕггогНра ; если произошла ошибка, вызываем обработчик 


11.1.13. Функция 14Р 


Функция позволяет выполнить диагностику внутреннего контроллера жест- 
ких дисков. 

Использование: 

1. В регистр дн следует поместить код функции 14ъ. 


2. Вызвать прерывание зпе 135. 


Выход: 


После выполнения функции в регистр Ан будет записан код состояния 
(см. табл. 11.1), а в регистр Ат, — значение оов. Флаг се в случае ошибки бу- 
дет установлен в 1, иначе сброшен. 


11.1.14. Функция 75Р 


Эта функция позволяет получить тип установленного диска. 


Использование: 
1. В регистр дн следует поместить код функции 153. 


2. В регистр ръ следует поместить номер жесткого диска. Номера жестких 
дисков лежат в диапазоне вов—гЕЪ, а номера гибких — 00—7Е®. 


3. Вызвать прерывание 1пе 13ь. 


Выход: 


После успешного выполнения функции в регистр дн будет записан один из 
следующих кодов: 005 — диск отсутствует, о1н — флоппи-диск, 028 — 
флоппи-диск или другое устройство со сменными носителями, озв — жест- 
кий диск. Флаг се в случае ошибки будет установлен в 1, иначе сброшен. 
В сх:ох будет помещено число секторов размером 512 байт. Не рекоменду- 
ется использовать данную функнию для проверки установленного типа 
диска. 


11.1.15. Функция 76Р 


Функция предназначена для отслеживания процесса смены носителя на 
флоппи-дисководе. Используйте данную функцию, если необходимо кон- 
тролировать процесс замены дискеты в устройстве. 
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Использование: 
1. В регистр Ан следует поместить код функции 16ъ. 


2. В регистр рр следует поместить номер флопни-диска. Номера дисков ле- 
жат в диапазоне 00и—7 ЕВ. 


3. Вызвать прерывание 1пе 135. 


Выход: 


Если флаг ск сброшен, значит, изменения отсутствуют, и в регистр дн будет 
записано значение ооъ (диск не менялся). Если флаг ск установлен в 1, зна- 
чит, произошли изменения, и в регистр ан будет помещено определенное 
значение: 016 — недопустимая команда (для некоторых специфических уст- 
ройств), 06» — диск был заменен или смена носителя не поддерживается, 
80 — диск не готов или отсутствует носитель. Рассмотрим простой пример 
работы с данной функцией, представленный в листинге 11.10. 





поу АН, 16\ ; функция 168 
поу ОЬ, 001 ; первый диск 


106 135 ; вызываем прерывание 

)с ЕгкогНпа ; произошла смена носителя, обрабатываем ситуацию 

спр АН, Обр ; диск был заменен 

3е РтТ5К СНАМСЕ; передаем управление в процедуру обработки ситуации 

спр АН, 801 ; диск не готов 

3е № ВЕАРУ ; можем вызвать процедуру № _ВЕАШУ для ожидания готовности 


11.1.16. Функция 171 


Данная функция устанавливает тип диска для последующей операции фор- 
матирования. Она используется для флоппи-дисков, но не поддерживает 
дискеты размером 1,44 Мб. Для работы с такими дискетами следует приме- 
нять функцию 185. 


Использование: 

1. В регистр Ан следует поместить код функции 178. 

2. В регистр аъ нужно записать код формата, имеющий одно из следующих 
значений: 01ь — 320 или 360 Кб для диска размером 360 Кб, о2ь — 320 


или 360 Кб для диска размером 1,2 Мб, озь — 1,2 Мб для диска размером 
1,2 Мб, 04н — 720 Кб для диска размером 720 Кб. 


3. В регистр рь следует поместить номер флоппи-диска. Номера дисков ле- 
жат в диапазоне 00ъ—7ЕЪ. 


4. Вызвать прерывание 1те 133. 
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Выход: 


После выполнения функции в регистр Ан будет записан код состояния 
(см. табл. 11.1), а в регистр АЪ — значение ооъ. Флаг сг в случае ошибки бу- 
дет установлен в |, иначе сброшен. 


11.1.17. Функция 18В 


Функция позволяет установить тип носителя для последующей операции 
форматирования. 


Использование: 
1. В регистр Ан следует поместить код функции 18. 


2. В регистр сн следует записать младшие 8 битов максимального количест- 
ва цилиндров минус один. 


3. В регистр съ нужно указать количество секторов на одной дорожке (биты 
0—5), а также два старших бита (6 и 7) номера цилиндра. 


4. В регистр рт, следует поместить номер флоппи-диска. Номера дисков ле- 
жат в диапазоне 001—7 Ев. 


5. Вызвать прерывание 1пе 13ъ. 


Выход: 


После выполнения функции в регистр Ан будет записано одно из следую- 
щих значений: 005 — требуемая комбинация значений поддерживается, 
011 — ошибка выполнения функции, ось — диск не поддерживается или 
имеет неизвестный тип, 805 — отсутствует носитель в дисководе. Кроме то- 
го, при успешном выполнении функции в Ез:0т будет помещен указатель 
на таблицу параметров (обычно размером 11 байт). 

жж 


На этом мы завершим рассмотрение стандартных функций и перейдем к 
описанию дополнительного набора функций, особенно актуального в со- 
временных операционных системах \Мтдо\з. Эти функции используют про- 
грессивную логическую адресацию (ГВА — Гояса! Воск А@агез$), что по- 
зволяет поддерживать устройства размером более 528 Мбайт (используя 
28-битный адрес можно работать с дисками размером до 137,4 Гбайт). Кро- 
ме того, они позволяют работать с дисками в системах без поддержки В1О$ 
и являются совместимыми с современными протоколами передачи данных 
(например, ОМА). Для работы с дополнительными функциями также при- 
меняется прерывание 1пе 133. Список всех функций приведен в табл. 11.4. 
Прежде чем рассказать об этих функциях, я хотел бы объяснить, как нуме- 
руются современные дисководы. Имеются два канала, каждый из которых 
поддерживает два устройства. Каналы нумеруются следующим образом: пер- 
вый канал содержит устройства Оеусе 0 (ведущее) и Ое\мсе 1 (ведомое), 
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второй канал также содержит устройства Пемсе 0 (ведущее) и Ое\уке 1 (ве- 
домое). Нумерация дисков начинается с номера вов и присваивается после- 
довательно первому и второму устройствам на первом канале, а затем пер- 
вому и второму устройствам на втором канале. Если жесткий диск 
подключен ведущим на первом канале, привод ОУО подключен ведомым на 
этом же канале, а привод СО-К\! подключен ведущим на втором канале, то 
нумерация устройств будет следующей: вон — жесткий диск, 81: — привод 
РУО, 82. — привод СО-ЕВ\.. Если, например, у вас установлены два уст- 
ройства (жесткий диск и привод СО-ВМ\/) как ведущие на обоих каналах, 
нумерация будет выглядеть так: 805 — жесткий диск, 81. — привод СО-КУ\. 
Некоторые дополнительные функции (для записи, чтения и проверки дан- 
ных) используют специальный пакет данных для указания адреса на диске. 
Сделано это для упрощения доступа к различным типам дисков, исполь- 
зующих различные способы адресации (СН$ или ВА). Размер пакета дол- 
жен быть не менее 16 байт и иметь формат, представленный в табл. 11.5. 


Таблица 11.4. Список дополнительных функций 


Код функции Описание 


418 Проверка поддержки дополнительного набора функций 
42в Расширенное чтение данных 

а3в Расширенная запись данных 

44В Проверка секторов 

455 Блокировка носителя 

468 Извлечение носителя 

47Ь Расширенный поиск 

485 Получение параметров устройства 

498 Получение расширенной информации о смене диска 


Таблица 11.5. Формат пакета данных для адреса 


Смещение Размер Описание 


ов ВУТЕ Размер пакета в байтах 

018 ВУТЕ Зарезервировано и равно 0 
02В ВУТЕ Количество блоков 

оЗв ВУТЕ Зарезервировано и равно 0 


04в рмовр — Адрес буфера хоста 
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Таблица 11.5 (окончание) 


Смещение Размер Описание 


о8в ОМОвЬ Стартовый логический адрес 
108 Оиовр Линейный адрес буфера 

18 в рИОВО Количество блоков 

1Св БИОВО Зарезервировано и равно 0 


Приведем краткий комментарий к табл. 11.5. 


С Смещение оон определяет размер пакета адреса в байтах. Это значение 
должно быть не меньше 16 байт, иначе вызываемая функция возвратит 
ошибку (Ан равен о1н). 


С) Смещение о1ь зарезервировано и должно быть установлено в 0. 


С Смещение 02в определяет количество блоков с данными, которые долж- 
ны быть переданы устройству. Максимальное значение не должно пре- 
вышать 127 блоков, иначе вызываемая функция вернет ошибку (Ан равен 
011). При установке байта в 0 никакие данные переданы не будут. Если 
установить значение байта в ЕЕВ, будет использоваться линейный адрес 
со смещением 10ъ, а количество блоков будет определяться значением 
в смещении 183. 


О Смещение озь зарезервировано и должно быть установлено в 0. 


С) Смещение 04ь определяет адрес буфера данных для хоста. Данный буфер 
будет использован для записи или чтения данных. Если значение адреса 
установлено в ЕЕРЕН: ЕКЕЕН, будет использован адрес буфера со смещени- 
ем 10ъ. 


О Смещение озь определяет начальный логический адрес (64-разрядный) 
на диске, необходимый для передачи данных. Для устройств с СНЗ- 
адресацией заданное значение будет преобразовано, а для устройств с 
[ВА-адресапией — передано без изменений. Пересчет [ВА-адреса в СН$ 
осуществляется по следующей формуле: 


ГВА = (С1* НО+Н!|) * $50 + $1 — 1, где 

С! — номер выбранного цилиндра; 

НО — число головок (номер максимальной головки плюс один); 
Н! — номер выбранной головки; 

$0 — максимальное значение секторов; 

51 — номер выбранного сектора. 


С) Смешение 10н определяет линейный адрес буфера данных для хоста. 
Данный буфер будет использован для записи или чтения данных. Это поле 
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используется, если в смещении 0о4п установлено значение ЕЕЕЕЬ: ЕЕРЕВ 
или количество блоков со смешением о2н установлено в гЕЕЪ. 


С Смещение 185 определяет количество блоков, которые должны быть пе- 
реданы. Используется только в случае, если значение количества блоков 
в смещении 02. установлено в ЕЕЪ. 


О Смещение 1св зарезервировано и должно быть установлено в 0. 


11.1.18. Функция 411 


Функция Позволяет проверить поддержку устройством дополнительного на- 
бора функций. Функпия работает со всеми устройствами. 


Использование: 
1. В регистр Ан следует поместить код функции 411. 


2. В регистр вх нужно записать значение 55АлАЬ. 


3. В регистр рь следует поместить номер устройства. Нумерация устройств 
должна лежать в диапазоне от 801 до 83в (четыре дисковода). 


4. Вызвать прерывание 11 138. 


Выход: 

Флаг переноса сЕ в случае ошибки будет установлен в 1, а в регистр ан бу- 
дет записано значение 01: (недопустимая команда). Это значит, что допол- 
нительный набор функций не поддерживается указанным устройством. Если 
флаг сг сброшен, результат выполнения будет распределен следующим об- 
разом: ан — номер версии дополнительного набора функций (для третьей 
версии значение равно 301), АТ — внутренняя информация В10$, вх — код 
55ААБ, СХ — битовая маска поддерживаемых возможностей (табл. 11.6). 
Установка какого-либо бита маски в [1 говорит о поддержке соответствую- 
щей возможности, 


Таблица 11.6. Битовая маска для функции 415 


Бит Описание 


0 Поддерживаются функции доступа к жесткому диску (413, 425, 43Ъ, 44в 
47В И 488) 

1 Поддерживаются функции блокировки и смены носителя (451, 46ъ, 48. 
и 498) 

2 Поддерживается функция 485 

3 Поддерживаются 64-битные расширения 


4—15 — Установлены в 0 
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В листинге 11.11] рассмотрим пример для определения поддержки дополни- 
тельного набора функций для второго устройства. 


- Листинг 11.11. Определение поддержки набора расширенных функций 


поу АН, 41 ; функция 418 

гох ВХ, 55ААВ; обязательное значение 

пох ОБ, 811 ›; второй диск 

106 138 ; вызываем прерывание 

с МО ЗУРРОВТ; набор дополнительных функций не поддерживается 
спр ВХ, 55ААБ; проверяем полученное значение 

Эпе ЕВВОК_НМО; произошла ошибка 

сезЕ СХ, 01 ; есть ли поддержка функций доступа 

32 МО АССЕ$$; нет 

СезЕе СХ, 0106; есть ли поддержка функций блокировки и смены носителей 
32 МО ТОСК ; нет 


Этот пример чисто демонстрационный. В реальной программе следует рас- 
пределить выполнение условий в зависимости от результата функции 41ъ. 


11.1.19. Функция 421 


Эта функция позволяет прочитать данные с диска в выделенный буфер па- 
мяти. 

Использование: 

|. В регистр Ан следует поместить код функции 42ъ. 


2. В регистр ръ следует поместить номер устройства. Нумерация устройств 
должна лежать в диапазоне от 805 до 83в (четыре дисковода). 


3. В оз:эзт нужно записать пакет адреса для диска. 
4. Вызвать прерывание 1пе 13н. 


Выход: 

Флаг переноса ск в случае ошибки будет установлен в 1, а в регистр дн бу- 
дет записано значение кода ошибки (см. табл. 11.1). При успешном выпол- 
нении операции флаг се будет сброшен, а в регистр АН записано значение 
оп. В случае ошибки поле счетчика индексов (в пакете адреса) будет со- 
держать число реально прочитанных блоков данных. Рассмотрим пример 
кола для чтения первого сектора диска (листинг 11.12). 





Листинг 11.12. Чтение первого сектора жесткого диска 





; определяем буфер для возвращаемых данных размером 512 байт 
Ратабесеог ОВ 512 ПОР ({?) 
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; определяем массив для пакета адреса и обнуляем 
РасаРаск РВ 16 РУР (0) 

; общий код программы 

; проверяем поддержку устройством дополнительных функций 
поу АН, 416 ; функция 418 

поу ВХ, 55ААР; обязательное значение 

шоу ОГ, 80. ; первый диск 

106 135 ; вызываем прерывание 

3с №0 $ОРРОВТ; набор дополнительных функций не поддерживается 
сшр ВХ, 55ААВ; проверяем полученное значение 

эпе ЕВВОВ_НМО; произошла ошибка 

поу [РабаРаск], 16; указываем минимальный размер пакета адреса 
поу [РабаРаск + 2], 1; нужно прочитать один блок 

; указываем адрес буфера данных 

поу [мога рег ПабаРаск + 4], ОЕЁзеЕ Рабабесвкох 

поУ АХ, 105 

поу [мога рег ПабсаРаск + 6], АХ 

; указываем логический адрес первого сектора на диске 
поу [4мога рЕг ПабаРаск + 8], 0 

поу [4мога рег ПабаРаск + 12], 0 

поу АН, 421 ; функция чтения данных 

поу ОГ, 801 ; первый диск 

оу ЭТ, ОЕЁЕзеё РабаРаск; указатель на пакет адреса 

ре 135 ; вызываем прерывание 





11.1.20. Функция 43В 


Функция предназначена для записи данных на диск из указанного буфера 
памяти. 

Использование: 

|. В регистр дн следует поместить код функции 43ъ. 


2. В ль следует поместить условие записи (0 или | — для выполнения запи- 
си без проверки, 2 — с последующей проверкой записанных данных). 

3. В регистр рь, следует записать номер устройства. Нумерация устройств 
должна лежать в диапазоне от 805 до 83зь (четыре дисковода). 

4. В рз:эт нужно записать пакет адреса для диска. 


5. Вызвать прерывание 1пе 131. 


Выход: 

Флаг переноса сЕ в случае ошибки будет установлен в 1, а в регистр Ан бу- 
дет записано значение кода ошибки (см. табл. 11.1). При успешном выпол- 
нении операции флаг се будет сброшен, а в регистр Ан записано значение 
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сов. В случае ошибки поле счетчика индексов (в пакете адреса) будет со- 
держать число реально записанных блоков данных. Рассмотрим демонстра- 
ционный пример записи первого сектора диска (листинг 11.13). 





Листинг 11.13. Запись первого сектора жесткого диска 
; определяем буфер для записываемых данных размером 512 байт 
Расазесеог ОВ 512 РУР (0) 

; определяем массив для пакета адреса и обнуляем 
РафаРаск РВ 16 ПОР (0) 

; общий код программы 
; проверяем подцержку устройством дополнительных функций 
поу АН, 41 ; функция 41 
поу ВХ, 55ААБ; обязательное значение 
шоу ОЬ, 8ОН ›; первый диск 
10 138 ; вызываем прерывание 
3с МО ЗОРРОВТ; набор дополнительных функций не поддерживается 
сир ВХ, 55ААБ; проверяем полученное значение 
Зпе ЕВВОВ_ НМО; произошла ошибка 
шоу [РабаРаск], 16; указываем минимальный размер пакета адреса 
поУу [РабаРаск + 2], 1; нужно записать один блок 
; указываем адрес буфера данных 
поу [мог рЕг БасаРаск + 4], оЕЁзее Рафабесвог 
поу АХ, 105 
шоу [мог рЕг РафаРаск + 6], АХ 
; указываем логический адрес первого сектора на диске 
поу (@мога рег РабаРаск + 8], 0 
шоу (Змоха рег РабсаРаск + 12], 0 


поу АН, АЗН ; функция записи данных 

поу РЬ, 80Н ›; первый диск 

поу УТ, ОЕЁзее ВабаРаск; указатель на пакет адреса 
1пЕ 136 ; вызываем прерывание 


Не пытайтесь повторить этот код, чтобы не затереть загрузочную область 
диска! Пример приведен только для иллюстрации работы с функцией 4зв. 


11.1.21. Функция 441 


Данная функция позволяет проверить указанные сектора без перемещения 
их между устройством и памятью. 

Использование: 

|. В регистр Ан следует поместить код функции 44ъ. 


2. В регистр от, следует поместить номер устройства. Нумерация устройств 
должна лежать в диапазоне от 805 до 83н (четыре дисковода). 
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3. В рз:5т нужно записать пакет адреса для диска. 
4. Вызвать прерывание +пе 135. 


Выход: 

Флаг переноса сЕ в случае ошибки будет установлен в [, а в регистр дн бу- 
дет записано значение кода ошибки (см. табл. 11.1). При успешном выпол- 
нении операции флаг се будет сброшен, а в регистр дн будет записано зна- 
чение оон. В случае ошибки поле счетчика индексов (в пакете адреса) будет 
содержать число реально проверенных блоков данных. 


11.1.22. Функция 45В 


Эта функция позволяет логически блокировать сменные носители для ука- 
занного устройства. Может применяться и для жестких дисков, если они 
поддерживают такую возможность (функция 411). Каждой блокировке 
должна соответствовать обратная операция. После включения питания или 
перезагрузки системы все блокировки будут автоматически сняты. 


Использование: 
1. В регистр Ан следует поместить код функции 455. 
`2. В регистр Аг, следует указать тип операции’ ооъ — блокировать носитель 


в устройстве, 016 — разблокировать носитель в устройстве, 02. — полу- 
чить состояние блокировки (есть или нет). 


3. В регистр рт следует поместить номер устройства. Нумерация устройств 
должна лежать в диапазоне от 80= до 8зв (четыре дисковода). 


4. Вызвать прерывание 11+ 13в. 


Выход: 


Флаг переноса се в случае ошибки будет установлен в |, а в регистр дн за- 
писано значение кода ошибки (см. табл. 11.1). При успешном выполнении 
операции флаг ск будет сброшен, в регистр Ан будет записано значение оон, 
ав Ар. — состояние блокировки (1 — носитель блокирован, 0 — носитель 
разблокирован). Например, чтобы блокировать третий диск (например, при- 
вод СО-КОМ), можно использовать код из листинга 11.14. 


: Листинг 11.14. Блокировка диска 


поу АН, 451 ; функция 458 


шоу АГ, ООН ; блокировать носитель на диске 
поу О, 82. ; номер диска 
10Е 136 ; вызываем прерывание 


3с ЕВВОВ_НМО; произошла ошибка 
поу АН, 45 ; функция 456 


362 Часть 1. Работа с аппаратными ресурсами в ИЛпдомз 


поу АБ, 025 ; проверяем состояние блокировки 

шоу ОЪ, 826 ; номер диска 

зпЕ 136 ; вызываем прерывание 

с ЕВВОВ НМО; произошла ошибка 

стр АБ, 1 ; проверяем, блокировано ли устройство 
пе № ТЪОСК ; устройство не заблокировано 


11.1.23. Функция 468 


Функция позволяет извлечь носитель из указанного дисковода, если по- 
следний поддерживает такую возможность. 


Использование: 
|. В регистр Ан следует поместить код функции 465. 
2. В регистр Ат, следует записать значение 0.0н. 


3. В регистр рт следует поместить номер устройства. Нумерация устройств 
должна лежать в диапазоне от 805 до 83зн (четыре дисковода). 


4. Вызвать прерывание 1пе 135. 


Выход: 


Флаг переноса се в случае ошибки будет установлен в 1, а в регистр АН 
будет записано значение кода ошибки (см. табл. 11.1). При успешном вы- 
полнении операции флаг ск будет сброшен, а в регистр Ан будет записано 
значение обт. Пример использования данной функции показан в листин- 
ге 11.15. 


поу АН, 412 ; функция 410 

поУу ВХ, 55ААБ; обязательное значение 

поу РЬ, 812 ; второй диск 

зпЕ 136 ; вызываем прерывание 

3с № З$УРРОВТ; набор дополнительных функций не поддерживается 

спр ВХ, 55ААБР; проверяем полученное значение 

пе ЕВВОВ_НМО; произошла ошибка 

фезЕ СХ, 0105; есть ли поддержка функций блокировки и смены носителей 
32 № ТОСК ; нет 

шоу АН, 462 ›; функция 468 





поУу АБ, ООВ $; всегда 0 
поу РЬ, 811 ; второй диск 
106 136 ; вызываем прерывание 


3с ЕВВОВ_НМО; произошла ошибка 
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11.1.24. Функция 47В 


Эта функция позволяет найти данные на диске, запрашиваемые компьюте- 
ром (программой). При успешном выполнении функции считывающая ме- 
ханика диска будет установлена в заданную позицию. 


Использование: 
1. В регистр Ан следует поместить код функции 47ъ. 


2. В регистр рь следует поместить номер устройства. Нумерация устройств 
должна лежать в диапазоне от зон до 8зв (четыре дисковода). 


3. В оз: эт нужно записать пакет адреса для диска. 
4. Вызвать прерывание 1пе 13Ъ. 


Выход: 


Флаг переноса се в случае ошибки будет установлен в 1, а в регистр дн бу- 
дет записано значение кода ошибки (см. табл. 11.1). При успешном выпол- 
нении операции флаг сг будет сброшен, а в регистр Ан будет записано зна- 
чение 00ъ. Функция возвратит управление, даже если операция поиска не 
будет закончена. 


11.1.25. Функция 48В 


Функция позволяет получить различные параметры устройства. Она под- 
держивается всеми устройствами. 

Использование: 

1. В регистр ан следует поместить код функции 488. 


2. В регистр рт, следует поместить номер устройства. Нумерация устройств 
должна лежать в диапазоне от 801 до 8зв (четыре дисковода). 


3. В оз: эт нужно записать адрес буфера данных. 
4. Вызвать прерывание 1пе 138. 


Выход: 


Флаг переноса се в случае ошибки будет установлен в 1, а в регистр дн 
будет записано значение кода ошибки (см. табл. 11.1). При успешном вы- 
полнении операции флаг сг будет сброшен, а в регистр Ан будет записано 
значение ооъ. Буфер данных в р03:3зт будет содержать запрашиваемую ин- 
формацию. Формат буфера данных показан в табл. 11.7. 


Таблица 11.7. Формат буфера данных для функции 481 


Байт Тип Описание 


0—1 МОК Размер выделенного буфера в байтах (должен быть не 
менее 30 байтов) 


364 


34—35 
36—39 
40—47 
48—55 
56—71 
72 
73 


Тип 
МОВО 
ОМОВО 
РМОВО 
рМОвр 
ОМОвО 
МОВО 


ОИОВО 


МОВО 


ВУТЕ 


ВУТЕ 
МОВО 
АЗСТТ (4 байта) 
АЗСТТ (8 байт) 
ОМОвр 
2 омовр (16 байт) 
ВУТЕ 


ВУТЕ 
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Таблица 11.7 (окончание) 


Описание 


Дополнительные информационные флаги 

Количество цилиндров по умолчанию 

Количество головок по умолчанию 

Количество секторов на одной дорожке по умолчанию 
Количество секторов 

Размер одного сектора в байтах 


Указатель на расширенную таблицу параметров 
устройства (ОРТЕ) 


Значение оверов, идентифицирующее наличие пути 
для устройства 


Размер данных о пути к устройству (должен быть 
равен аан)} 


Резерв 

Резерв 

Строковое значение для типа шины хоста 
Тип интерфейса 

Путь к интерфейсу 

Путь к устройству 

Резерв 


Контрольная сумма для данных, определяющих путь 
к устройству 


Приведем краткое описание табл. 11.7. 


С] Байты 0—1 содержат размер в байтах выделяемого буфера, записываемый 
вызывающей программой. Если размер буфера меньше 30 байтов, функ- 
ция не вернет информацию о параметрах устройства. Если размер буфера 
меньше 26 байтов, функция вернет ошибку. 


С Байты 2—3 содержат 16-битное значение, отдельные биты которого опре- 
деляют ту или иную возможность устройства. Формат этого значения 
представлен в табл. 11.8. Если бит установлен в 1, указанная возможность 
поддерживается. 


О Байты 4—7 указывают на общее количество цилиндров в устройстве. Это 
значение будет на | больше максимального номера цилиндра. Отсчет ве- 
дется с 0. 


О 


оо 


О 
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Таблица 11.8. Формат информационного параметра устройства 


Бит Описание 
0 Поддержка сообщений об ошибках (нарушение границы) для ОМА 
1 Значения в байтах 4—15 являются истинными 
Устройство поддерживает сменные носители 
Устройство поддерживает проверку во время записи 
Устройство поддерживает уведомляющие сообщения о смене носителя 


Устройство поддерживает блокировку носителя 


оп о № 


Выдаются максимальные значения для геометрии устройства, и носитель 
отсутствует 


7 Поддерживается функция 505 для доступа к устройству 


8—15 Резерв 


Байты 8—11 указывают на общее количество головок в устройстве. Это 
значение будет на | больше максимального номера головки. Отсчет ве- 
дется с 0. 


Байты 12—15 указывают на общее количество секторов на одной дорож- 
ке. Это значение будет равно максимальному номеру сектора. Отсчет ве- 
дется с 1. 


Байты 16—23 определяют полное количество секторов на диске. Это зна- 
чение будет на | больше максимального числа секторов. Отсчет ведется 
с 0. 


Байты 24—25 определяют количество байтов в одном секторе диска. 


Байты 26—29 определяют указатель на расширенную таблицу параметров 
устройства (ОРТЕ — Ремсе Рагатеег Тае Ежепзуоп). Данное поле дей- 
ствительно, если функция 41в установила бит 2 регистра сх в 1. Если 
таблица параметров не поддерживается, это поле будет установлено 
В ГЕРЕБ: КЕЕЕЬ. Кроме того, данное поле может присутствовать только 
в расширенном интерфейсе ПМТ 13 и поддерживается как АТА-, так и 
АТАР1-устройствами. 


Байты 30—31 должны содержать значение овеООВ, если присутствует ин- 
формация о пути к устройству. 


Байт 32 определяет размер информационного блока о пути к диску. Дол- 
жен быть установлен в 44. 


Байты 33, 34—35 зарезервированы и установлены в 0. 


Байты 36—39 определяют тип шины хоста, на которой установлено уст- 
ройство. Они представляют собой четыре АЗС -символа и могут прини- 
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мать одно из перечисленных в табл. 11.9 значений. Данные должны быть 
выровнены и дополнены при необходимости символом пробела (201). 


Таблица 11.9. Тип шины хоста 








Тип шины Описание типа шины Комбинация значений 
РС РС! оса! Виз 50н 436 495 208 
[ЗА Гедасу 16 Бй Яхеа Биз 49н 53 418 208 
РС|-Х РС1-Х Виз 50н 4Зн 49н 585 
ВМО пИлЮала 49п 42. АЕБ 44В 
ХРА$ РС! Ехргез$ 58й 508 528 53в 
НТРТ НурегТгапзрой Д8Н 541 508 54Н 





С Байты 40—47 определяют тип интерфейса. Представляют собой восемь 
АЗ$СП-символов и могут принимать одно из перечисленных в табл. 11.10 
значений. Данные должны быть выровнены и дополнены при необходи- 
мости символом пробела (208). 


Таблица 11.10. Тип интерфейса 








Тип Описание интерфейса Комбинация значений 

АТА АТА- и АТАР|-устройства, 415 545 418 208 208 2010 205 208 
поддерживающие команды АТА 

АТАР! АТА- и АТАР|-устройства, 416 54ав 4146 508 4986 208 208 208 
поддерживающие команды АТАР! 

$С$ Устройства $С$| 5Зн 4ЗЬ 53ЗВ 496 20Н 208 208 208 

и$В Устройства УЗВ для хранения 55Н 5ЗВ 428 208 205 208 208 208 
данных 

1394 Устройства 1394 для хранения 31 З3В 395 ЗАВ 208 208 208 208 
данных 

ЕВАЕ — Рьыге Сваппе! ден 49н 42ь 52, 455 20, 205 20, 

20 Интеллектуальные устройства 49. 32, аЕй 20. 208 208 208 205 
ввода-вывода 

ВАЮ Дисковый массив для хранения 52в 41в 490 44в 20. 208 208 208 
данных 


ЗАТА Зепа! АТА 5Зн 415 541 411 201 201 201 208 
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О Байты 48—55 указывают на идентификатор пути к интерфейсу диска, ко- 
торый имеет размер 8 байт. Формат этого поля представлен в табл. 11.11. 


Таблица 11.11. Формат поля для идентификатора пути к интерфейсу диска 








[ЗА Базовый 16-битный адрес 
50 Зарезервировано и равно 0 
52 Зарезервировано и равно 0 
РС 48 Номер шины РС! (00н—ЕЕв). Если значение равно 
ЕЕВ, значит, это поле не используется 
49 Номер слота на шине РС! (00ъ—еЕн). Если значе- 
ние равно ЕЕК, значит, это поле не используется 
50 Номер функции РС! (00,—=Ен). Если значение рав- 
НО ЕЕВ, значит, это поле не используется 
51 Номер канала. Позволяет различить первичный 
(003) и вторичный каналы (01в). Возможные значе- 
ния номера канала могут лежать в промежутке от 
00 до ЕЕВ. Если значение равно ЕЕЪ, значит, это 
поле не используется 
52 Зарезервировано и равно 0 
РС--Х 48 Номер шины РС]1-Х (00н—ЕкЕН). Если значение равно 
ЕКВ, значит, это поле не используется 
49 Номер слота на шине РС1-Х (о0п-—ЕЕН). Если значе- 
ние равно гг, значит, это поле не используется 
50 Номер функции РС-Х (00ъ—кЕв). Если значение 
равно кЕЪ, значит, это поле не используется 
51 Номер канала. Позволяет различить первичный 
(00) и вторичный каналы (01ъ). Возможные значе- 
ния номера канала могут лежать в промежутке от 
с0п до РЕВ. Если значение равно ЕЕЪ, значит, это 
поле не используется 
52 Зарезервировано и равно 0 
ВМО 48Ь Не определено 
ХРАЗ 485 Не определено 
НТРТ 48В Не определено 





 Байты 56—71 определяют идентификатор пути для устройства согласно 
табл. 11.12. 
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т 
АТА 


АТАР! 


$05 


$8 


1394 
РВАЕ 


120 


ВАЮ 
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Таблица 11.12. Формат поля для идентификатора пути к диску 


56 
57 
58 
60 
64 
56 
57 
58 
59 
60 
64 
56 
58 
66 
68 
56 
64 
56 
64 
56 
64 
56 
64 
56 
60 
64 





ООВ 


ООВ 


Номер АТА-устройства (00п — первое Оемсе 0, 
01н — второе Оемее 1} 


Зарезервировано и равно 0 
Зарезервировано и равно 0 
Зарезервировано и равно 0 
Зарезервировано и равно 0 


Номер АТАР!-устройства (00% — первое Оемсе 0, 
01н — второе Оемее 1) 


Логический номер устройства 
Зарезервировано и равно 0 
Зарезервировано и равно 0 
Зарезервировано и равно 0 


Зарезервировано и равно 0 





Идентификатор физического устройства $С$1 
Логический номер устройства 
Зарезервировано и равно 0 


Зарезервировано и равно 0 





Номер устройства размером 64 бита 
Зарезервировано и равно 0 


Уникальный идентификатор устройства (Е\|-64) 
размером 64 бита 


Зарезервировано и равно 0 








ОМОВО 


ООВ 





Общемировой идентификатор устройства (\М/М/О) 
размером 64 бита 


Логический номер устройства 
Идентификатор устройства размером 64 бита 
Зарезервировано и равно 0 


Номер ВАЮ-массива, в который входит данное 
устройство 


Зарезервировано и равно 0 


Зарезервировано и равно 0 
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56 


Таблица 11.12 (окончание) 


Описание 


ВУТЕ | Номер ЗАТА-устройства (оон — первое Оемсе 0, 
011 — второе Ое\месе 1) 











ЗАТА 


57 Зарезервировано и равно 0 
58 


60 


Зарезервировано и равно 0 
Зарезервировано и равно 0 


64 Зарезервировано и равно 0 


С Байт 72 зарезервирован. 


С Байт 73 определяет значение контрольной суммы для данных пути к уст- 
ройству с учетом сигнатуры овЕррь. Вычисляется в виде двоичного до- 
полнения суммы значений без знака для смещений от 30 до 72. Сумма 
значений для диапазона 30—73 равна 0. 


Для приложений. не использующих расширенный интерфейс [МТ 13, мож- 
но воспользоваться расширенной таблицей текущих параметров устройства 
(ОРТЕ). Формат таблицы показан в табл. 11.13. 


Таблица 11.13. Формат расширенной таблицы параметров диска 


Смещение Размер Описание 


0—1 МОВр Базовый адрес порта ввода-вывода 
2—3 ИОВ Адрес управляющего регистра 
4 ВУТЕ Регистр устройства 
5 ВУТЕ Зарезервирован для ВОЗ 
6 ВУТЕ Номер прерывания 
7 ВУТЕ Число повторений для многоразовых команд чтения 
и записи 
8 ВУТЕ Информация о ОМА 
9 ВУТЕ Тип пакетного режима 
10—11 ИОВ Дополнительная информация 
12—13 ОВО Зарезервировано и равно 0 
14 ВУТЕ Определяет версию таблицы и равно 11+ (в третьей версии} 


15 ВУТЕ Контрольная сумма 
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Приведем краткое пояснение к табл. 11.3. 


| 


| 


Байты 0—1 указывают на 16-разрядный базовый адрес порта устройства 
для операций ввода-вывода. 


Байты 2—3 указывают на 16-разрядный адрес управляющего регистра 
устройства. 


Байт 4 содержит текущий формат управляющего регистра устройства 
{табл. 11.14). 


Таблица 11.14. Формат управляющего регистра устройства 


Бит Описание 


0—3  Равны 0 
4 Бит номера устройства (0 — Оемсе 0, 1 — Оемсе 1) 
5 Равен 1 
6 Режим [ВА (1 — используется} 
7 Равен 1 


Байт 5 используется В1ОЗ для внутренних целей. 


Байт 6 — номер выделенного устройству прерывания. Биты 4—7 всегда 
равны 0, а биты 0—3 определяют номер прерывания. 


Байт 7 определяет количество повторений для передачи блоков данных, 
используемых в некоторых специфических командах АТА (команды для 
многократной записи или чтения). 


Байт 8 указывает на номер канала ОМА (биты 0—3) и тип режима ОМА 
(4—7). 


Байт 9 определяет параметры режима РТО (Ргозгаттея шру/Ошри — 
программируемый ввод-вывод). Биты 4—7 равны 0, а биты 0—3 содержат 
тип режима РЮО. 


Байты 10—11 определяют дополнительные флаги. Формат значения этого 
поля показан в табл. 11.15. Если бит установлен в 1, опция используется. 


Таблица 11.15. Дополнительные флаги 


Бит Описание 


0 Используется режим Газ{ РЮ. Если этот бит установлен, информация 
в байте 9 доступна 


1 Используется ОМА. Если этот бит установлен, информация в байте 8 
доступна 
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Бит 


очоаяльо № 


9—10 


11 


12—15 


Таблица 11.15 (окончание) 


Описание 


Используются команды многократной записи или чтения 
Используется адресация для эмуляции СНЗ 

Используется адресация ЕВА 

Устройство поддерживает сменные носители (например, СО-ВОМ) 
Устройство поддерживает пакетные команды 

Устройство поддерживает 32-разрядный режим передачи данных 


Определяет готовность устройства АТАР! к передаче данных, если бит 6 
равен 1 


Определяет тип преобразования адресов для СНЗ (001 — поразрядный 
сдвиг, 01п — ЕВА, 02, — резерв и озь — определяется производителем), 
если бит 3 равен 1 


Используется режим Ийга ОМА совместно с байтом 8 


Зарезервировано и равно 0 


С Байты 12—13 зарезервированы и должны быть равны 0. 


С Байт 14 определяет версию таблицы и должен быть равен 11ъ. 


С Байт 15 определяет контрольную сумму для всех байтов в таблице. 


Рассмотрим простой пример для получения информации о параметрах уст- 
ройства (листинг 11.16). 








` Листинг 11.16. Получение информации об устройстве 





; определяем буфер для возвращаемых данных 
21$КТоРо РВ 74 РУР (?) 
; общий код программы 


; 


; проверяем поддержку устройством дополнительных функций 


Ом 
Ом 
ТО 
1оЕ 


АН, 
вх, 
ОГ, 
13В 


418 ; функция 416 
55ААН; обязательное значение 
816 ; второй диск 

; вызываем прерывание 


Эс МО ЗУРРОВТ; набор дополнительных функций не поддерживается 
спр ВХ, 55ААЙ; проверяем полученное значение 

Эпе ЕВВОВ_НМО; произошла ошибка 

; получаем информацию для указанного устройства 


ПоУ 


АН, 


485 ; функция 488 
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поу 0, 811 ; второй диск 

по\у [мога рёг Р15КТоРо], 30; указываем минимальный размер блока данных 
по\у ЭТ, ОЕЁзеф Р1$ъКТоЁЕо; передаем указатель на буфер данных 

10Е 138 ; вызываем прерывание 

с ЕВВОВ_НМО; произошла ошибка 


11.1.26. Функция 49Р 


Функция позволяет определить, была ли выполнена пользователем смена 
носителя. При каждой попытке заменить носитель устройство вырабатывает 
определенный сигнал. 
Использование: 

В регистр дн следует поместить код функции 498. 


2. В регистр рт следует поместить номер устройства. Нумерация устройств 
должна лежать в диапазоне от 8ов до 8зъ (четыре дисковода). 


3. Вызвать прерывание 1пЕ 13ъ. 


Выход: 

Флаг переноса се будет установлен в | (Ан равен о6ъ), если произошла сме- 
на носителя, и сброшен в обратном случае (Ан равен оон). В листинге 11.17 
проверяется момент замены (или попытки замены) носителя. 





@гереаф: 

шоу АН, 491 ; функция 496 

шоу РГ, 808 ; первый диск 

10Е 136 ; вызываем прерывание 

]пс @гереаф ; повторяем опрос, если замена не производилась 


11.1.27. Функция 4ЕР 


Эта функция позволяет установить конфигурацию аппаратного обеспечения 
для работы с дисками. С помощью данной функции можно сконфигуриро- 
вать контроллер на материнской плате так, чтобы максимально оптимизи- 
ровать работу указанного устройства. Несмотря на то, что один канал под- 
держивает два дисковода, эта функция выполнит конфигурацию только для 
одного. 


Использование: 
В регистр Ан следует поместить код функции 4ЕЪ. 


2. В регистр ль нужно записать номер команды (табл. 11.16). 
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3. В регистр от, следует поместить номер устройства. Нумерация устройств 
должна лежать в диапазоне от вов до 8зь (четыре дисковода). 


4. Вызвать прерывание 1пе 131. 


Таблица 11.16. Список команд 


Код команды Описание 


в Использовать предвыборку 

16 Не использовать предвыборку 

28 Использовать максимально быстрый режим РЮ 

ЗЬ Использовать режим Р!О 0 

45 Восстановить режим Р!О, используемый по умолчанию 
58 Использовать максимально быстрый режим ОМА 

6В Блокировать доступ к ОМА для прерывания 1п= 135 


Выход: 

Флаг переноса сг в случае ошибки будет установлен в 1, а в регистр Ан бу- 
дет записано значение кода ошибки (см. табл. 11.1). При успешном выпол- 
нении операции флаг се будет сброшен, в регистр дн будет записано значе-. 
ние 00, а в регистр Ат — код выполнения (0 — команда выполнена 
правильно, 1 — выполнение команды повлияло на другие устройства). 


Рассмотрим небольшой пример для установки максимально быстрого режи- 
ма РО, представленный в листинге 11.18. 


оу АН, 4ЕВ ; функция 4ЕБ 


поу АЦ, 28 ; самый быстрый режим РТО 
поу РЬ, 826 ; третий диск 
106 136 ; вызываем прерывание 


)3с ЕВВОВ_НМО; произошла ошибка 
сшр АБ, 0 ; проверяем корректность выполнения функции 
902 ЕВВОК НМО; некорректное выполнение функции 


11.1.28. Функция 507 


Функция позволяет подготовить В1О$ к передаче данных для устройства, 
использующего пакетный режим работы (например, привод СО-КОМ). 
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Использование: 
1. В регистр Ан следует поместить код функции 501. 


2. В регистр Ат, нужно записать номер подфункции р7в. 


3. В регистр рь следует поместить номер устройства. Нумерация устройств 
должна лежать в диапазоне от 805 до 831 (четыре дисковода). 


4. В Ез:зт следует записать указатель на форматированную пакетную 
команду согласно табл. 11.17. 


5. Вызвать прерывание 1пЕ 13ъ. 


Таблица 11.17. Формат пакетной команды 


Смещение Размер Описание 


0 Се) 53) Размер пакета в байтах 


2—п ВУТЕ Отформатированные данные пакетной команды 


Выход: 


При успешном выполнении флаг се будет очищен, а в регистр Ан будет за- 
писано значение ооъ. Если произошла ошибка, флаг се будет установлен, а 
в регистр Ан будет записано одно из следующих значений ошибки: 018 — 
функция не поддерживается, 80. — команда не была завершена, 975 — 
подфункция р7ь не поддерживается данным устройством, сзн — отформа- 
тированный блок пакетной команды имеет размер менее допустимого. 


Данная команда помогает использовать подмножество команд ЗС$Е (Зта| 
Сотршег Зужет Ние!асе — системный интерфейс малых вычислительных 
машин) для управления устройствами, работающими в пакетном режиме: 
АТАРГ, 1394, Ц$В и 5С$Е Что такое пакетные команды и для чего они 
нужны, будет рассматриваться далее в этой главе. В табл. 11.18 показан 
стандартный формат пакетной команды, указатель на который помещается 
в регистр Ез: эт. 


Таблица 11.18. Формат 16-байтной пакетной команды 





Смещение Размер Описание 





0—1 ОВО Размер пакета команды в байтах 
2 ВУТЕ Дополнительная информация 
З ВУТЕ Код пакетной команды 
4—7 БИОВр Указатель на пакет данных команды 


8—15 рИОВо Количество байт для передачи следующего блока данных 
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Таблица 11.18 (окончание) 


Смещение Размер Описание 


16—19 риОвр — Указатель на начало буфера данных 
20—21 МОВр Время ожидания 
22—23 МОВЬ Приращение времени 


Приведем краткое описание таблицы. 
С) Байты 0—1 определяют размер пакетной команды в байтах. 


С] Байт 2 содержит дополнительную информацию. Биты 0—5 зарезервиро- 
ваны и должны быть установлены в 0. Биты 6 и 7 определяют направле- 
ния передачи данных: 


® 00н — передается только команда без дополнительных данных; 
® 01. — данные передаются от устройства к компьютеру; 

® 02н — данные передаются от компьютера к устройству; 

® 035 — будет выполнен сброс интерфейса. 


С Байт 3 содержит код пакетной команды или 0, если команда не исполь- 
зуется. 


С] Байты 4—7 должны содержать указатель на дополнительные данные па- 
кетной команды, которые будут переданы. Если данное поле установлено 
в ноль, оно игнорируется. 


С Байты 8—15 определяют число байтов, которые будут переданы со сле- 
дующей командой. 


9 Байты 16—19 определяют начало буфера данных, которые должны быть 
переданы. 


С Байты 20—21 содержат время ожидания в миллисекундах перед началом 
посылки пакетной команды. Если это поле установлено в 0, функция 
вернет ошибку (801). 


С Байты 22—23 определяют приращение времени ожидания. Количество 
передаваемых данных делится на размер сектора и умножается на задан- 
ное в этом поле значение. Полученный результат будет добавлен к обще- 
му времени ожидания. Максимальное значение не должно превышать 
КЕГЕБ. Если выполняется передача только кода команды или сброс ин- 
терфейса, данное поле игнорируется. 


И еше разберем одну функцию, использующую прерывание 11 158 и 
имеющую отношение к интерфейсу П\Т 13. 
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11.1.29. Функция 521 


Функция позволяет извлечь из устройства сменный носитель. Она вызыва- 
ется ВГОЗ$ при использовании команды 465. Программы кэширования могут 
перехватывать данное прерывание для своевременного сохранения данных 
на диске. 


Использование: 
1. В регистр Ан следует поместить код функции 525. 


2. В регистр рт, следует поместить номер устройства. Нумерация устройств 
должна лежать в диапазоне от вон до 83ъ (четыре дисковода). 


3. Вызвать прерывание 1пе 151. 


Выход: 

При успешном выполнении флаг сг будет очищен, а в регистр Ан будет за- 
писано значение о0ъ. Если произошла ошибка, флаг се будет установлен, а 
в регистр дн будет записано одно из следующих значений ошибки: в1ь — 
носитель блокирован, взь — носитель недоступен. Рассмотрим пример кода 
для извлечения носителя из устройства СО-КОМ (установлен ведущим на 
втором канале), показанный в листинге 11.19. 





‚ Листинг 11. 19. Извлечение сменного носителя из устройства СО-КВОМ 


; предположим, что имеется только два дисковода: жесткий и СО-ВОМ 
поу АН, 526 ›; функция 526 

поу БГ, 811 ; второй диск 

1пе 156 ; вызываем прерывание 

с ЕВВОВ НМО; произошла ошибка 


А теперь дополнительно рассмотрим набор функций В1О$ для поддержки 
загрузочных дисков. Для работы с этими функциями используются две 
стандартные структуры данных: для описания технических требований 
(табл. 11.19) и типа передаваемой команлы (табл. 11.21). 


Таблица 11.19. Формат структуры описания технических требований 


Смещение Размер Описание 


0 ВУТЕ Размер пакета (13+) 

1 ВУТЕ Тип носителя 

2 ВУТЕ Номер диска 

З ВУТЕ Индекс контроллера СО-диска 


4-7 риОвр — Логический адрес 
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Таблица 11.19 (окончание) 





Смещение 


14—15 
16 
17 
18 


Размер 


"ОВО 


"ОВО 


МОК 


МОВО 


ВУТЕ 


ВУТЕ 


ВУТЕ 


Описание 


Технические требования для загрузочного диска 

Размер сегмента данных пользователя 

Сегмент загрузки для диска 

Счетчик количества секторов 

Младшее значение числа цилиндров 

Количество секторов и старшее значение числа цилиндров 


Число головок 


Приведем краткий комментарий к таблице. 


С Байт 0 определяет размер всего пакета и должен быть установлен в 13%. 


0 Байт | определяет тип носителя и дополнительные данные. Формат этого 
байта приведен в табл. 11.20. 


Бит Описание 


Таблица 11.20, Формат байта описания типа носителя 


0—3 — Тип эмулируемого устройства (005 — эмуляция отсутствует, 01 — диск раз- 
мером 1,2 Мб, о2ь — диск размером 1,44 Мб, озь — диск размером 2,88 Мб, 
04н — жесткий диск С:) 


4—5 — Зарезервированы и должны иметь значение 0 


6 Установка бита в 1 позволяет использовать интерфейс АТАР! (биты 8 и 9 
должны быть установлены для устройств Е) 


7 Установка бита’в 1 позволяет использовать интерфейс 5С$1 (биты 8 и 9 
должны быть установлены для устройств $С$!1) 


0 Байт 2 определяет номер диска. Возможны следующие значения: 00в — 
для эмуляции образа гибкого диска, вов — для автозагрузочного жесткого 
диска, 81'—ЕЕр — без автозагрузки и эмуляции. 


2 Байт 3 должен указывать на номер контроллера для устройства компакт- 


ДИСКОВ. 


С) Байты 4—7 определяют логический адрес для диска. 


С Байты 8—9 определяют параметры адресации дисков для интерфейсов 
СУГ и ШЕ. Если используется 5С$Т, байт 8 указывает на логический 
номер устройства (1 №), а байт 9 — на номер шины. Если используется 
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интерфейс ШЕ, байт 8 указывает на номер устройства (0 для ведущего 
или | для ведомого), а байт 9 не применяется. 

С Байты 19—11 определяют размер сегмента данных для пользователя. 


С Байты 12—13 определяют загрузочный сегмент, используемый функцией 
4ср. Если записать в это поле значение оон, будет использован стандарт- 
ный сегмент 7соъ. 


С Байты 14—15 определяют значение виртуального счетчика секторов, ко- 
торый используется в функции 4скв. 


О Байт 16 должен содержать младшие 7 бит для количества цилиндров. 
Данное значение возвращает функция овъ в регистре съ. 


СО Байт 17 состоит из двух частей. Биты 0—5 должны определять количество 
секторов, а биты 6 и 7 — описывать старшие два разряда для количества 
цилиндров. 


С Байт 18 определяет количество головок диска. Данное значение возвра- 
щает функция 085 в регистре он. 


Таблица 11.21. Формат структуры для типа передаваемой команды 


Смещение Размер Описание 


0 ВУТЕ Размер структуры (08) 

1 ВУТЕ Количество секторов в каталоге начальной загрузки, кото- 
рые требуется передать 

2 риовр Указатель на адрес буфера, который используется для 
каталога начальной загрузки 

6 ОВО Значение первого сектора в каталоге начальной загрузки 
(оон) 


11.1.30. Функция ЗАВ 
Данная функция позволяет инициализировать эмуляцию диска. 


Использование: 
|. В регистр Ан следует поместить код функции 42Ъ. 


2. В регистр Ат нужно записать значение оо. 


3. В о$:5т необходимо записать указатель на пакет описания технических 
требований. 


4. Вызвать прерывание 10 135. 
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Выход: 


При успешной инициализации эмуляции диска флаг сг будет сброшен, а 
если система не поддерживает режим эмуляции — установлен. В регистр Ан 
будет записан код выполнения (см. табл. 11.1). 


11.1.31. Функция 4ВВ 


Эта функция позволяет завершить режим эмуляции. диска и восстанавливает 
используемое по умолчанию загрузочное устройство. Кроме того, данную 
функцию можно использовать для проверки установленного режима эму- 
ляции. 

Использование: 

1. В регистр Ан следует поместить код функции 4вв. 

2. В регистр Ат, нужно записать код команды. Поддерживаются следующие 


значения: 00р — возвратить состояние и завершить режим эмуляции, 
015 — возвратить только текущее состояние. 


3. В регистр оь следует записать номер диска, для которого будет завершен 
режим эмуляции. Если установить значение 7гп, режим эмуляции будет 
завершен для всех дисков. 


4. В о$:зт необходимо записать указатель на пустой пакет описания техни- 
ческих требований. 


5. Вызвать прерывание 1пе 13,. 


Выход: 


При успешном завершении режима эмуляции диска флаг сг будет сброшен, 
а если система не находится в режиме эмуляции — установлен. В регистр Ан 
будет записан код выполнения (см. табл. 11.1). В р$:5зт будет записан пакет 
описания технических требований. 


11.1.32. Функция 4СВ 


Функция позволяет инициализировать эмуляцию диска и выполнить переза- 
грузку системы. 


Использование: 
1. В регистр ан следует поместить код функции 4сь. 
2. В регистр Ат, нужно записать значение оов. 


3. В р$:5т необходимо записать указатель на пакет описания технических 
требований. 


4. Вызвать прерывание зе 131. 
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Выход: 


Если функция выполнена успешно, возврашаемое значение отсутствует. 
* * * 


На этом мы завершим описание функций ВЮЗ и перейдем к непосредст- 
венному программированию портов. 


11.2. Использование портов 


Работа напрямую с портами является не такой сложной задачей, как может 
показаться сразу. Однако для правильной работы требуется хорошо знать 
структуру регистров дисковых устройств, а также иметь представление о 
протоколах работы с различными типами команд и интерфейсов. Сначала 
мы познакомимся с программированием накопителей на гибких дисках 
(флоппи-дисководов). 


11.2.1. Регистры флоппи-дисковода 


Для работы с данным устройством используются порты ЗЕОЪ—ЗЕ7Ь. Каждый 
из этих портов взаимодействует с определенным регистром дисковода. На- 
значение каждого регистра приведено в табл. 11.22. Некоторые из них вы- 
полняют двойную роль. 


Таблица 11.22. Список портов ввода-вывода для флоппи-дисковода 





Регистр Режим работы Описание 





ЗРОВ Чтение Зарезервирован 

ЗЕ1 Чтение и запись Дополнительный регистр состояния (ЗАВ) 

ЗЕ2В Чтение и запись Регистр цифрового вывода (ООВ) 

ЗЕЗВ Чтение и запись Регистр управления лентопротяжным механизмом 
(ТОВ) 

ЗЕАВ Чтение Основной регистр состояния {М$ЗВ) 

ЗЕАВ Запись Регистр управления скоростью передачи данных (038) 

ЗЕ5Н Чтение и запись Регистр данных (ЕЕ О) 

ЗЕбВ — Зарезервирован 

ЗЕ7В Чтение Регистр цифрового ввода (ГВ) 

ЗЕ7В Запись Регистр управления конфигурацией (ССВ) 


Рассмотрим каждый из регистров подробнее. 
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11.2.1.1. Дополнительный регистр состояния 


Этот регистр определяет текущее состояние устройства. Может применяться 
как для чтения, так и для записи. Использует порт под номером зЕ1ь. Фор- 
мат регистра показан в табл. 11.23. 


Таблица 11.23. Формат дополнительного регистра состояния 











Описание 
Чтение 


Запись 


Приведем краткий комментарий к таблице. 


С Бит 0 определяет текущее состояние простоя (СП) устройства и доступен 
в режиме чтения регистра. 


С Бит 2 служит для управления режимом простоя (УП). Если бит установ- 
лен в 1, то блокируется возможность выключения питания через регистр 
О$К (Даагже З@еси Керлуег). Восстановить нормальный режим можно 
только с помошью перезагрузки системы. 


Для использования этого регистра необходимо, чтобы он был включен 
управляющей командой (бит ЕКЕС ЕМ установлен в |). Бит ЕКЕС ЕМ (Еп- 
Вапсе Керлуег Епае) применяется для включения дополнительного реги- 
стра статуса. Пример считывания данного регистра приведен в листин- 
ге 11.20. 


хог АЦ, АЦ ; обнуляем регистр 

поу ОХ, ЗЕЛЬ ; указываем порт 

11 АБ, ОХ ; читаем из порта один байт 
фезЕ АГ, 016 ; проверяем бит 0 

Зе РОМЕВ_ОРЕ; питание отключено 

пе РОМЕВ_ОМ ; питание включено 


Аналогичный пример на С++ показан в листинге 11.2]. 
: Листинг 11.21. Считывание информации из регистра состояния в С++ 
// пишем функцию для проверки состояния питания 


Боо1 ТиРомегкроми () 


{ 


ОМОВО З“Вези1Е = 0; // переменная для хранения результата 
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// читаем состояние порта 

1пРоге ( 0х3Е1, &ЧмВезо1Е, 1); 

1Е ( ( ЧмВезо1Е & 0х01) == 0х01) гебагр %гоае; 
тесагп ЁЕа15$е; 


11.2.1.2. Регистр цифрового вывода 


Этот регистр позволяет управлять мотором флоппи-дисковода. Он использу- 
ет порт под номером зЕЗЪ. Может применяться как для чтения, так и для 
записи. Формат регистра показан в табл. 11.24. 


Таблица 11.24. Формат регистра цифрового вывода 


ЕО О СЕ 


Приведем комментарий к таблице. 







Описание 





С Бит 0 позволяет выбрать номер устройства. Возможны следующие значе- 
ния: 0 — первый дисковод (1св) или | — второй дисковод (205). 


С Бит 1 зарезервирован и должен быть установлен в 0. 


С Бит 2, установленный в 0, позволяет выполнить сброс устройства. После 
того как выполнена операция сброса, данный бит устанавливается в 1. 


С Бит 3, установленный в 0, блокирует прерывания и доступ устройства 
к ОМА, иначе доступ разрешен. 


С Бит 4 управляет двигателем для первого (Опуе 0) дисковода (| — двига- 
тель запущен, 0 — двигатель выключен). 


С Бит 5 управляет двигателем для второго (Оиуе 1) дисковода (| — двига- 
тель запущен, 0 — двигатель выключен). 


СО Биты би 7 зарезервированы и должны быть установлены в 0. 


Перед началом работы с дисководом следует включить двигатель. Для за- 
пуска двигателя первого дисковода можно применить код из листинга 11.22. 





поу ОХ, ЗЕ2П ; указываем порт 


шоу АБ, 0 ; выполняем сброс 

оцс ОХ, АБ ; записываем значение в порт 

поу АЬ, 1Ср ; инициализируем первый дисковод и запускаем двигатель 
оцЕ ОБ, АБ ; записываем значение в порт 


поу СХ, 4000 ; устанавливаем небольшое ожидание для разгона двигателя 
@ае1ау: 
1оор @4е1ау ; двигатель раскрутится после завершения цикла 
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Для выключения двигателя достаточно выполнить код из листинга 11.23. 


шоу ПХ, ЗЕ2В ; указываем порт 
пох АГ, ОСП ; останавливаем двигатель 
ое ОГ, АБ ; записываем значение в порт 


Аналогичный пример на С++ показан в листинге 11.24. 





Листинг 11.24. Управление двигателем флоппи-дисковода в С++ 
// пишем функцию для инициализации дисковода и управления двигателем 

уУо1а То1ЕЕОО ( Боо1 ОБх1уе) 

{ 


1Е ( 0г1уе) // выполнить инициализацию и включить двигатель 
{ 
очЕРогЕ ( ОхЗЕ2, 0х1С, 1); 
З1еер ( 500); // ожидаем 0,5 секунды, пока двигатель раскрутится 
} 
е1зе // выключить двигатель 
{ 
очЕРОгЕ ( ОхЗЕ2, 0х0С, 1); 


11.2.1.3. Регистр управления лентопротяжным механизмом 


Данный регистр позволяет выбирать для определенного диска используемый 
лентопротяжный механизм. После этого любые обращения к диску будут 
переданы выбранному механизму. Восстановить регистры можно только че- 
рез аппаратный сброс. Он использует порт под номером зЕзЗь. Может при- 
меняться как для чтения, так и для записи. Формат регистра показан в 
табл. 11.25. Описание данного регистра рассматривается для контроллера 
фирмы Ш. 


Таблица 11.25. Формат регистра управления лентопротяжным механизмом 


ПОС ИЕ ОСИ ОЕ ОЕ ИИ 


Авто ЛМ 1 
Резерв 
Авто ЛМ 1 


оо ооо фм | мм! 












Описание 
Чтение 


Запись 
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Приведем краткое описание таблицы. 


С Бит 0, установленный в 1, позволяет блокировать первый лентопротяж- 
ный механизм для первого дисковода (Опуе 0). По умолчанию первый 
дисковод является загрузочным. 


С Бит 1, установленный в 1, позволяет блокировать второй лентопротяж- 
ный механизм для первого дисковода (Опуе 0). 


С Бит 3 управляет выбором загрузочного дисковода. По умолчанию бит ра- 
вен 0. При этом первому дисководу соответствует первый лентопротяж- 
ный механизм, а второму дисковолу — второй. Если бит равен 1, первому 
дисководу будет сопоставляться второй лентопротяжный механизм, а 
второму — первый. 


Пользоваться этим регистром не рекомендуется из-за различий использова- 
ния его производителями (Ние!, Ма). 


11.2.1.4. Основной регистр состояния 


Этот регистр применяется для получения информации о завершении раз- 
личных управляющих команд. Использует порт под номером зЕАв. Может 
применяться только для чтения. Формат регистра показан в табл. 11.26. 


Таблица 11.26. Формат основного регистра состояния 


РО Е ИС СИ Е ОЕ ОСЗ ПОС ИС 


Приведем краткий комментарий к таблице. 





С Бит 0 установлен в 1, когда первый дисковод (Ошуе 0) ищет данные 
команды или находится в режиме калибровки. 


С Бит 1 установлен в 1, когда второй дисковод (Оиуе 1) ищет данные 
команды или находится в режиме калибровки. 


С Биты 2 и 3 зарезервированы и равны 0. 
С Бит 4 установлен в 1, когда происходит выполнение команды. 


С Бит 5, установленный в 1, определяет передачу данных без использова- 
ния режима ОМА. 


С Бит 6 определяет направление передачи (НП) данных. Если бит равен 0, 
передача осуществляется от хоста к флоппи-дисководу, а когда бит уста- 
новлен в 1 — от флоппи-дисковода к хосту. 


О Бит 7 информирует о готовности дисковода к приему данных. Если бит 
равен 1, можно передавать данные, если же бит установлен в 0, дисковод 
не готов к приему данных и следует подождать. 
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Например, если регистр содержит значение 90}, значит, выполняется 
команда и требуется подождать. А если в регистре записано значение 8олп, 
значит, контроллер готов принять очередную команду. 


11.2.1.5. Регистр управления скоростью передачи данных 


Регистр позволяет настроить параметры для скорости передачи данных. 
Управление скоростью передачи необходимо для совместимости с более 
старыми устройствами. Использует порт под номером зг4в. Может приме- 
няться только для записи. Формат регистра показан в табл. 11.27. 


Таблица 11.27. Формат регистра управления скоростью передачи 















Описание Предкомпенсация Скорость 





Приведем краткое описание таблицы. 


О Биты 0—1 позволяют установить одну из четырех возможных скоростей 
передачи данных. Список поддерживаемых значений показан в табл. 11.28. 
По умолчанию используется скорость 250 Кбит в секунду. 


Таблица 11.28. Список скоростей 


Значение битов Ои 1 Скорость 
005 500 Кбит/сек 
015 300 Кбит/сек 
10 250 Кбит/сек 
11 1 Мбит/сек 


О Биты 2—4 определяют время задержки предкомпенсации. Это необходи- 
мо, поскольку магнитные носители имеют физически обоснованные за- 
держки при намагничивании. Для компенсации магнитных явлений ис- 
пользуется задержка по времени, измеряемая в наносекундах. Возможные 
значения для этого поля представлены в табл. 11.29. По умолчанию ис- 
пользуются следующие задержки: для скорости передачи 1 Мбит/сек — 
41,67 нс, а для скоростей 250—500 Кбит/сек — 125 нс. 


О Бит 5 управляет питанием задающего кварцевого генератора (ЗКГ). Уста- 
новка бита в | позволит отключить подачу питания на генератор. Изме- 
нение этого бита следует выполнять только в режиме пониженного энер- 
гопотребления. 
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Таблица 11.29. Значения времени задержки 


Код задержки Время, нс 

0005 По умолчанию 
001 41,67 

0105 83,34 

0115 125,00 

1005 166,67 

1015 208,33 

1105 250,00 

1115 0,00 (не используется) 


С Бит 6 управляет подачей питания к дисководу. При установке бита в | 
флоппи-дисковод будет переведен в режим пониженного потребления 
энергии. Аппаратный или программный сброс восстанавливает полный 
уровень подачи питания. 


3 Бит 7, установленный в 1, позволяет выполнить программный сброс кон- 
троллера, после чего он устанавливается в 0. 


Рассмотрим пример кода для установки скорости передачи данных, пока- 
занный в листинге 11.25. 





пох ОХ, 
пох АЦ, 
сие ВХ, 
поу АЦП, 
очЕ ПЦ, 
пох СХ, 
пох ОХ, 
поу АГ, 
оцЕ ПХ, 


Листинг 11.25. Установка желаемой скорости : 


й 
й 
й 
й 


; 





указываем порт 
выполняем сброс 

записываем значение в порт 

инициализируем первый дисковод и запускаем двигатель 
записываем значение в порт 

устанавливаем небольшое ожидание для разгона двигателя 
указываем порт 

300 Кбит/сек и 125,00 нс 

записываем значение в порт 


Аналогичный пример для С++ представлен в листинге 11.26. 





// раскручиваем двигатель и выполняем инициализацию 
( ОхзЕ2, 0х1С, 1); 


опЕРоге 
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// ожидаем 0,5 секунды, пока двигатель раскрутится 

З1еер { 500); 

// устанавливаем скорость 300 Кбит/сек и время 125,00 нс 
оиЕРоге ( ОхЗЕ4А, 0хОр, 1); 


11.2.1.6. Регистр данных 


Этот регистр предназначен для обмена данными между флоппи-дисководом 
и хостом (компьютером). Использует порт под номером зЕ5ъ. Может при- 
меняться как для чтения, так и для записи. Размер регистра данных равен 
16 байтам. 


11.2.1.7. Регистр цифрового ввода 


Регистр использует порт под номером зе7ь. Может применяться только для 
чтения. Задействован только старший бит (7), а остальные не используются. 
Если происходит смена диска, бит будет установлен в [. 


11.2.1.8. Регистр управления конфигурацией 


Данный регистр позволяет установить скорость передачи данных 
(см. табл. 11.28). При этом используются только биты 0 и 1. Остальные 
должны быть равны 0. Использует порт под номером ЗЕ7?ь. Может приме- 
няться только для записи. 


11.2.2. Команды управления 
для флоппи-дисковода 


Для управления флоппи-дисководом используется специальный набор 
команд. Весь процесс выполнения команды можно разделить на три основ- 
ные фазы: посылка команды, выполнение и получение результата. В первой 
фазе через регистр данных передается сама команда (строгая последователь- 
ность определенных байтов). Далее наступает вторая фаза. когда контроллер 
выполняет команду. После завершения обработки команды наступает по- 
следняя фаза, в которой считывается результат выполнения команды. Спи- 
сок команд показан в табл. 11.30. 


Таблица 11.30. Список команд для флоппи-дисковода 


Имя команды Описание 

ВЕАР РАТА Чтение данных 

ВЕАР РЕГЕТЕО РАТА Чтение удаленных данных 
МЕТТЕ ОАТА Запись данных 


ИВТТЕ РЕБЕТЕОР РАТА Запись удаленных данных 
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Таблица 11.30 (окончание) 


Имя команды Описание 


ВЕАО ТВАСК Чтение дорожки 


УБВТЕУ Проверка данных 


КОВМАТ ТВАСК Форматирование дорожки 


ВЕСАГТВВАТЕ Рекалибровка устройства 


ЗЕМЗЕ ТМТЕВВОРТ 5ТАТОЗ Получить состояние прерывания 


ЗЕМЗЕ РАТУЕ $ТАТОЗ Получить состояние флоппи-дисковода 


ЗЕБК Поиск 


ВЕАР ТР Получить идентификатор 


Каждая из представленных команд имеет собственные значения параметров. 
Для упрощения работы используются специальные сокращения, полный 
список которых представлен в табл. 11.31. 


Таблица 11.31. Список принятых сокращений для описания параметров команд 


Сокращение Описание 

АОТО РВ Автоматическое управление энергопотреблением (0 — отключено, 
1 — включено) 

С Номер цилиндра (от 0 до 255} 

00, 01 Выбор дисковода от 0 до 3 

[9 Шаблон данных для форматирования каждого сектора 

ОА Управление движением головки (0 — от шпинделя, 1 — к шпинделю} 

050, 0$1 Выбор дисковода (005 — первый, 015 — второй) 

ОТЕ Размер сектора (если М больше 0, сюда следует записать ЕЕЪ, 
если М равно 0, сюда записывается количество байтов для чтения 
или записи) 

ОВАТЕ [0:1] Скорость передачи данных в регистре О$ВН 

ОАТО, ОАТ1 Выбор таблицы скорости передачи данных (регистры ОЗВ и ССВ) 

ОТО, ОТ1 Выбор типа плотности для диска | 

ЕС При установке бита в 1 разрешается счетчик для команды провер- 
ки данных УЕНЕРУ 

ЕНЕО Управление работой Е!РО (0 — разрешить, 1 — запретить} 
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Сокращение 


Е!$ 


ЕОТ 
ЕВЕС ЕМ 


САР 
СРЕ 
РОО, Е01 
НО$ 
НЕТ 
НОТ 
Еоск 
МЕМ 


РСМ 


РС2, РС2, РСО 
РВО$С 
РТЗ 


РОЕЕ 


РВЕТВАК 
А 
$С 


Таблица 11.31 (продолжение) 


Описание 


Управление поиском (0 — не использовать поиск, 1 — выполнять 
поиск в фазе выполнения команды перед операцией чтения или 
записи) 


Конец дорожки (финальный номер сектора для текущей дорожки) 


Включение дополнительного регистра состояния (0 — использовать 
стандартный регистр, 1 — использовать ТОВ- и ЗАВ-регистры) 


Размер промежутка 2 для перпендикулярного режима 
Размер промежутка 3 для расстояния между секторами 
Выбор флоппи-дисковода (006 — первый, 015 — второй) 
Номер головки (0 или 1} 

Время готовности к работе головки 

Время удержания головки в рабочем состоянии 
Блокирует параметры ЕНТО, РВЕТВК и РРОТНВ 


Установка бита в 1 включает режим двойной плотности для записи 
данных 


Установка мультидорожечного режима работы (1 — включить) 


Код размера сектора в байтах (00 — 128 байт, о1н — 256 байт, 
02н — 512 байт, озн — 1024 байта, одн — 2048 байт, 
05. — 4096 байт, обн — 8192 байта, отн — 16 384 байта) 


Номер очередного цилиндра для операции поиска 
Управление режимом ОМА (0 — разрешен, 1 — запрещен) 


Установка бита в 1 позволит отключить фазу результата 
выполнения команды 


Номер текущего цилиндра, получаемый с помощью команды зЕМЗЕ 
ТМТЕВКОРТ ЗТАТОЗ 


Значение предкомпенсации в регистре ОЗВ 
Если бит равен 1, тактовый генератор отключен 


Выбор предкомпенсации (0 — регистр ОЗВ настроен 
на определенное время задержки, 1 — задержка не используется) 


Управление режимом внутреннего фпроса 
(0 — включен, 1 — выключен) 


Номер стартовой дорожки для предкомпенсации (00н—ЕЕН) 
Номер сектора 


Количество секторов 


390 Часть 1. Работа с аппаратными ресурсами в И/паои$ 


Таблица 11.31 (окончание) 


Сокращение Описание 


к Флаг пропуска (1 — сектора, помеченные как удаленные, будут 
пропущены; 0 — сектора будут прочитаны или записаны) 


ЗАТ Временной интервал движения головки в миллисекундах 
(от 0,5 до 8 с шагом 0,5) 


$ТО, $Т1, $Т2 Внутренние регистры статуса (определяют результат выполнения 
команды) 


А теперь разберем сами команды для работы с флоппи-дисководом и кон- 
троллером. 


11.2.2.1. Команда ВРЕАР ОАТА 


Эта команда предназначена для чтения данных. Размер команды равен 
9 байтам (2 байта описания команды и 7 байтов с параметрами). В третьей 
фазе команды возвращаются 7 байтов. Формат команды для первой и треть- 
ей фаз показан в табл. 11.32. 


Таблица 11.32. Команда ВЕАР РАТА 


Первая 
фаза 


Третья 
фаза 
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Размер блока данных в байтах, которые будут считаны, определяется пара- 
метром М. При мультидорожечной операции (бит МТ установлен) данные 
будут считываться одновременно с двух дорожек (табл. 11.33). 


Таблица 11.33. Размеры передаваемых данных 


Количество 
секторов 
на дорожке 


Размер одного Размер данных, 
сектора, байт байт 


26 6656 
52 13312 
15 7680 
30 15360 





После выполнения команды будут возвращены, в том числе, и 3 байта ста- 
туса: $ТО, 5Т1, $Т2. По ним можно судить о результате выполнения опера- 
ции. Форматы этих байтов показаны соответственно в табл. 11.34, 11.35 и 
11.36. 


Таблица 11.34. Формат байта статуса $ТО 











Описание 






завершения 
(1С) 


Поиск | Ошибка Не Номер диска 
(ЗЕ) (ЕС) готов | головки (45) 
(МА) (НО) 

Приведем краткое описание таблицы. 

О Биты 0—1 содержат номер дисковода. 

О Бит 2 определяет номер головки дисковода. 

О Бит 3 будет установлен в 1, если дисковод не готов к работе. 

О Бит 4 указывает на ошибку в работе дисковода, если установлен в 1. 


С Бит 5 установлен в 1 после выполнения команды поиска. 





О Биты 6—7 определяют код завершения команды: 

® 005 — успешное завершение; 

® 015 — команда завершилась ошибкой; 

® 105 — неправильные параметры или код команды; 


Ф 11р — команда не выполнена из-за отсутствия диска в дисководе. 
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ет 11.35, т байта т $71 







Биты 
Описание —^— ии инк ее == Маркер 
(ЕМ) (РЕ) (ОВ) (№) (ММд (МА) 


Приведем описание таблицы. 


С Бит 0 установлен в 1, если отсутствует адресная метка (маркер), задавае- 
мая при форматировании диска. 


С Бит 1 устанавливается в 1, если выполняется попытка записи на защи- 
щенный диск. 


Бит 2 установлен в {1 при отсутствии данных в заданном секторе. 
Бит 4 установлен в 1, если переполнен буфер данных. 
Бит 5 установлен в 1, если возникла ошибка в передаваемых данных. 


Оооо 


Бит 7 установлен в 1, если выполнена попытка обращения к сектору, но- 
мер которого больше максимально возможного. 


Таблица 11.36. Формат байта статуса $Т2 


Биты 


СИЕ Е ЕЕ НИ 
Г "ЭГ [59 


Приведем краткий комментарий к таблице. 
С Бит 0 установлен в 1, если отсутствует адресная метка. 
С Бит 1 установлен в 1, если обнаружен дефектный цилиндр. 


С Бит 4 установлен в 1, если возникла ошибка с определением номера ци- 
линдра. 


С Бит 5 установлен в 1, если есть ошибка проверки по контрольной сумме 
СКС. 


С Бит 6 установлен в 1, если попалась метка для удаленных данных. 


Дополнительно существует еще один байт статуса (5Т3), формат которого 
представлен в табл. 11.37. 





Таблица 11.37. Формат байта статуса $ТЗ 








Номер диска 
(15) 









сторон 
(т5) 


головки 
(НО) 
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Приведем краткое описание таблицы. 
С Биты 1—0 определяют номер дисковода. 
С Бит 2 указывает на номер головки. 


О Бит 3 установлен в 1, если поддерживается работа с двусторонними дис- 
ками. 


С Бит 4 определяет текущую позицию головки, если она находится на ну- 
левой дорожке. 


О Бит 5 установлен в 1, если дисковод готов к работе. 
О Бит 6 установлен в 1, если дисковод защищен от записи. 





С Бит 7 установлен в 1, если произошла ошибка в устройстве. 


В листинге 11.27 показан пример кода для считывания одного байта инфор- 
мации. 


Листинг 11.27. Чтение одного байта 
бесВуееЕОр ргос пеаг 

оу ОХ, ЗЕ4В ; указываем порт 

@гереаф: 

1 АБ, ОХ ; читаем порт состояния 

ап АГ, ОСОв ; проверяем биты 6 и 7 

сир АЬ, ОСОН ; если установлены 


3е геаа рубе; переходим к чтению байта 
1оор @гереа® ; иначе повторяем 


геад_рузе: ; читаем байт 

11с 2х ; порт ЗЕ5Ь 

11 АБ, ОХ ; сохраняем байт в АБ 
ге 


сеЕВуфеЕОР епар 


Аналогичный пример для С++ показан в листинге 11.28. 


// пишем функцию для считывания одного байта 
ВУТЕ бееВуееЕОр () 
{ 
ОИОКР ЧмВез11е = 0; // переменная для хранения результата 
10е 1Тпаема1е = 50000; 
// читаем порт статуса, пока биты 6 и 7 не будут установлены в 1 
\р11е ( -- 1ТмеМма1® > 0) 
{ 
// читаем состояние порта 
ЗпРогЕ ( ОхЗЁР4, &амВези1, 1); 
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1Е ( ( амВеза1 & 0хС0) == 0хС0) ьгеак; 
// закончилось время ожидания 
1Е ( 1ТьмеМма1е < 1) гебагп ЕВВОВ Т1МЕ; 


} 

// читаем байт 

1пРоге ( ОхЗР5, &@мВеза1%, 1); 
гебаги (ВУТЕ) ЧмВези14; 


Для чтения сектора флоппи-диска необходимо выполнить следующую по- 
следовательность операций: 


1. Инициализировать устройство и включить двигатель. 


2. Установить скорость передачи данных или использовать заданную по 
умолчанию. 


Подождать не менее 0,5 сек, пока раскрутится двигатель. 
Провести рекалибровку. 

Инициализировать контроллер ОМА. 

Передать команду чтения. 


Включить счетчик времени ожидания. 


ючмуч-> 


Проверить прерывание от контроллера гибких дисков. Если прерывания 
нет, увеличить счетчик времени. По истечении времени ожидания сге- 
нерировать ошибку чтения данных и завершить программу. 


9. Если прерывание получено, прочитать блок данных (третья фаза). Если 
операция выполнена, завершить программу. 


10. Если операция не выполнена, сделать еще 3 попытки. Каждая попытка 
должна начинаться с 5-го пункта. 


11. Если в течение трех повторений не удалось прочитать данные, следует 
завершить программу с ошибкой чтения. 


Чтобы прочитать сектор диска, можно выполнить код из листинга 11.29. 


Листинг 11.29. Чтение сектора диска 


; выделяем буфер для считываемых данных 
Чата РаЕЁЕег ОВ 512 ПУР (?) 

; и буфер для байта статуса 

эсаеиз рубез ОВ 7 ОУР (?) 

ВеаЯ_ Зесфог ргос пеаг 

; запускаем двигатель 

поу ПОХ, ЗЕ2Ь ; указываем порт 

поу АБ, 0 ; выполняем сброс 
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очЕ ОХ, АБ ; записываем значение в порт 
шоу АБ, 1Ср ; инициализируем первый дисковод и запускаем двигатель 
опЕ ОБ, АБ ; записываем значение в порт 


шоу СХ, 4000 ; устанавливаем небольшое ожидание для разгона двигателя 
@Че1ау: 

1оор @49е1ау ; двигатель раскрутится после завершения цикла 
; выполняем рекалибровку 

са11 Веса11Ъгаее 

; устанавливаем начальную позицию 

са11 5еЕРоз 

; ждем, пока головка станет в указанную позицию 

оу СХ, 1800 ; не более 30 мс 

@гереах: 

1оор @гереаЕ 

; инициализируем ОМА 

са11 Тп1ЕРМА 

; читаем сектор 

поу АН, 661 ; команда ВЕАПР ВАТА 

са11 5еЕВуЕеЕОО; записываем первый байт команды 


по АН, 0 ; головка 0 и первый дисковод 
са11 5екВуееЕгОр; записываем второй байт команды 
шоу АН, 0 ; цилиндр 0 


са11 5еВуееЕОО; записываем третий байт команды 
поу АН, 0 ; головка 0 

са11 ЗефВуееЕОр; записываем четвертый байт команды 
пох АН, 1 ; сектор 1 

са11 5еВуеегОрО; записываем пятый байт команды 

шоу АН, 2 ; размер сектора для 512 байт 

са11 ЗефВуеегОО; записываем шестой байт команды 
поу АН, 131 ; номер последнего сектора для диска 1,44 
са11 5ееВуееЕгОО; записываем седьмой байт команды 
поу АН, 1ВЬ $; длина между секторами 

са11 Зе ВуееЕгОрО; записываем восьмой байт команды 
шоу АН, ОГЕН ; размер сектора не используется 

са11 Зе ВуеегОр; записываем восьмой байт команды 
са11 Ма1е ТМТ; ждем завершения команды 

; получаем результирующие байты 


пох СХ, 7 ; должно быть 7 байтов 

]1еа ВХ, эбабаз руфез; получаем адрес буфера 

@деЕ_ъусез: 

са11 СбефЕВузеЕро ; читаем байт 

поу [ВХ], АБ ; записываем в очередную позицию эбабаз_рубез 
тс ВХ ; переходим на следующий байт 


1оор @деЕ рубез; повторяем 7 раз 
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; глушим двигатель 

шоу ОХ, ЗЕ2Н ; указываем порт 

шоу АБ, ОСр ; останавливаем двигатель 
оцЕ ОБЬ, АБ ; Записываем значение в порт 
гее 

Веаа_бесфог епар 

; рекалибровка дисковода 

Веса11Юхафе ргос пеаг 


шоу АЁЬ, 7 ; команда КЕСАБЛВВАТЕ 
са11 5еЕВуЕеЕОО; записываем первый байт команды 
шоу АБ, 0 ; первый дисковод (А) 


са11 ЗееВуфегроро; записываем второй байт команды 
са11 Ма1_ТМТ; ждем завершения команды 

геё 

Веса11юхгабсе епар 

; процедура для ожидания прерывания дисковода 
Ма1<_ТМТ ргос пеаг; прерывание ТМТб 

шоу АХ, 401 ; данные ВТО$ 


пох Е5, АХ ; заносим в Е 
поу ВХ, ЗЕН ; определяем байт статуса 
@гереа*: ; проверяем бит 7 


моу РЬ, Е5: [ВХ]; копируем байт статуса 
фезе ОГ, 80В ; если бит 7 не равен 1 

32 @гереа® ; повторяем опрос 

апа РЬ, 7ЕБ $; обнуляем бит 7 

шоу Е5: [ВХ], 0Ь; обновляем байт статуса 
геЕё 

Ма1_ТМТ епар 

; процедура для установки позиции 
беёРоз ргос пеаг 

шоу АН, ОЕ ; команды ЗЕЕК 

са11 ЗефВусегррО; записываем первый байт команды 


шоу АЁЬ, 0 ; первый дисковод (А) 
са11 ЗефВусеЕОр; головка с номером 0, первый дисковод (А) 
шоу АН, 0 ; номер цилиндра для операции поиска 


са11 5еЕВуееЕОО; записываем третий байт команды 
са11 Ма1е ТМТ; ждем завершения команды 

ге 

ЗееРоз епар 

; инициализация ОМА 

То1ЕОМА ргос пеаг 


с11 ;} запрещаем прерывания 
шоу АБ, 46р ; команда ВЕАР РАТА 
оцЕ 12, АГ 


опЕ 11, АБ 
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поу АХ, ОЕЁзеф Чафа раЁЁег; адрес буфера данных 


шоу ВХ, 05 

пох СЬ, 4 

то1 ВХ, СЬ ; сдвигаем влево на 4 бита 
поу Оь, ВЬ 

апЯа ВЬ, ОРОБ ; обнуляем младшие 4 бита 

апа РЪ, ОГВ ; обнуляем старшие 4 бита 

а9а АХ, ВХ ; суммируем 

)Эпс @да1ее ; если СЕ = 0 

пс ОГ ; увеличиваем ОБЬ 

@Ча1ее: 

ое 4, АБ ; пишем младший байт смещения адреса 
поу АБ, АН } Старший байт смещения адреса 
оцЕ 4, АБ };} пишем старший байт 

поу АБ, РОЬ ; страница буфера РОМА 

сие 81Н, АБ ; записываем номер страницы 
поу АХ, 511 ; устанавливаем размер данных 
о 5, АБ ; пишем младший байт 

поу АБ, АН } старший байт 

оц 5, АБ ; пишем старший байт 

‚ мох АГ, 2 ; выделяем канал 2 

ое 10, АБ ; пишем выбранный канал ПМА 
51 ;} разрешаем прерывания 

хее 


То1ЕОМА епар 


11.2.2.2. Команда НЕАР ОЕГЕТЕО АТА 


Данная команда предназначена для чтения данных, в том числе и удален- 
ных. Размер команды равен 9 байтам (2 байта описания команды и 7 байтов 
с параметрами). В третьей фазе команды возвращаются 7 байтов. Команда 
аналогична команде вЕАО РАТА, за исключением первого байта (табл. 11.38). 


Таблица 11.38. Формат команды вЕАР РЕТЕТЕР РАТА 





Последовательность работы с данной команлой не отличается от обычной 
команды чтения. 


11.2.2.3. Команда И/РИТЕ АТА 


Команда позволяет записать данные на диск. Размер команды равен 
9 байтам (2 байта описания команды и 7 байтов с параметрами). В третьей 
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фазе команды возвращаются 7 байтов. Формат команды совпадает с 
ВЕАР БРАТА, за исключением первого байта (табл. 11.39). 


Таблица 11.39. Формат команды ивТтТЕ РАТА 





Для записи байта в порт можно использовать код, приведенный в листин- 
ге 11.30. 


Листинг 11.30. Запись одного байта 





ЗерВуееЕОР ргос пеаг 

поту ОХ, ЗЕАН ; указываем порт 
@тереа®: 

10 АБ, ОХ ; читаем порт состояния 
фезЕ АГ, 808 ; проверяем бит 7 

72 @гереа ; если бит 7 не равен 1, повторяем 
11с ОХ ; порт ЗЕ5В 

шоу АГ, АН ; передаем байт 

опЕ ОХ, АБ ; пишем байт в порт 

ге 

ЗеЕВуееЕОВ епар 


Аналогичный пример для С++ показан в листинге 11.31. 


Листинг 11.31, Запись одного байта в С++ 





// пишем функцию для записи одного байта 
Боо1 ЗеЕВуееЕОР ( ВУТЕ Рафа) 
{ 
ОМОВР ЯмВези1Е = 0; // переменная для хранения результата 
106 1ТмеМа1® = 50000; 
// читаем порт статуса, пока бит 7 не будет установлен в 1 
\р11е ( -- 1Тимема1е > 0) 
{ 
// читаем состояние порта 
1пРогЕ ( ОхЗЕА, &ЯЧмВезо1е, 1); 
1Е ( ( ЭмВезо1Е & 0х80) == 0х01) ЬБгеак; 
// закончилось время ожидания 
1Е ( 1Тиема1е < 1) гебагп Еа15е; 
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// пишем байт 
опЕРокЕ ( ОхЗЕ5, Раба, 1); 
тебагп 6гоае; 


11.2.2.4. Команда И/ВТЕ РЕГЕТЕР РАТА 


Эта команда позволяет записать данные на диск. Каждый записываемый 
сектор помечается как удаленный. Размер команды равен 9 байтам (2 байта 
описания команды и 7 байтов с параметрами). В третьей фазе команды воз- 
вращаются 7 байтов. Формат команды совпадает с ВЕАО РАТА, за исключе- 
нием первого байта (табл. 11.40). 


Таблица 11.40. Формат команды ИВТТЕ РЕТЕТЕР РАТА 





11.2.2.5. Команда РЕАР ТАВАСК 


Команда позволяет прочитать данные для указанной дорожки. Размер 
команды равен 9 байтам (2 байта описания команды и 7 байтов с парамет- 
рами). В третьей фазе команды возвращаются 7 байтов. Формат команды 
совпадает с ВЕАР РАТА, за исключением первого байта (табл. 11.41). 


Таблица 11.41. Формат команды ВЕАР ТКВАСК 





11.2.2.6. Команда УЕВТРУ 


Эта команда позволяет проверить данные на диске. Размер команды равен 
9 байтам (2 байта описания команды и 7 байтов с параметрами). В третьей 
фазе команды возвращаются 7 байтов. Формат команды показан в табл. 11.42. 


11.2.2.7. Команда РОРМАТ ТРАСК 


Данная команда позволяет отформатировать заданный носитель. Размер 
команды равен 6 байтам (2 байта описания команды и 4 байта с параметра- 
ми). Во второй фазе возвращается информация о форматировании текущего 
сектора. В третьей фазе команды возвращаются 7 байтов. Формат команды 
показан в табл. 11.43. 
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Таблица 11.42. Команда УЕВТЕУ 


Биты 
ва [8 [ао 
МТ МЕМ ЗК 1 1 1 0 
фаза С 
Н 
В 
М 
ЕОТ 
СРЕ 
ОТЕ/$С 
Третья То 
фаза $Т1 
та 
С 
Н 
В 
М 


Таблица 11.43. Команда ЕОЕМАТ ТЕАСК 


Первая 


фаза 
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Таблица 11.43 (окончание) 


Не определен 
Не определен 


Не определен 


Не определен 





В табл. 11.44 приводятся стандартные значения для некоторых полей команды. 


Таблица 11.44. Стандартные значения для форматирования дисков 












Размер СРЕ 
сектора, (чтение 
и запись) 


СРЬЕ 


Тип (формат) 


11.2.2.8. Команда ЛПЕСАНВНВАТЕ 


Эта команда позволяет установить головки дисковода в нулевую позицию. 
Размер команды равен 2 байта. Третья фаза отсутствует. Формат команды 
показан в табл. 11.45. После выполнения данной команды следует вызвать 
команду ЗЕМЗЕ ТМТЕВВОРТ ЗТАТОЗ длЯ получения результатов. 
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Таблица 11.45. Команда ВЕСАТТВЕАТЕ 





В листинге 11.32 показан пример кода, выполняющий рекалибровку для 
первого дисковода (А:). 


: Листинг 11.32. Выполнение рекалибровки флоппи-дисковода 





; рекалибровка дисковода 


шоу АЦ, 7 ; команда ВЕСАВВАТЕ 
са11 5$еЕВубеЕгОВ; записываем первый байт команды 
пох АГ, 0 ; первый дисковод (А:) 


са11 Зе ВуЕеЕОО; записываем второй байт команды 
са11 СеМа1ЕТМТ; ждем прерывания 


Этот же пример для С++ представлен в листинге 11.33. 





Листинг 11.33. Выполнение рекалибровки флоппи-дисковода в С++ 


// функция рекалибровки дисковода 
Уо1Я Веса11рга®еЕЬР ( опз1апе 10Е об1зк) 


{ 
ЗесВуееЕОО ( 0х07); // команда ВЕСАЦТВВАТЕ 
ЗеЕВуееЕОр ( (ВУТЕ) 1015$К); // первый дисковод (А:) 
СеЕма1етМТ (); // ждем прерывания 

} 


11.2.2.9. Команда ЗЕМ$Е 1МТЕРРВИРТ УТАТИ$ 


Данная команда позволяет получить информацию о состоянии прерывания 
для флоппи-дисковода. Размер команды равен 1 байту. В третьей фазе воз- 
вращаются 2 байта. Формат команды показан в табл. 11.46. 


Контроллер дисковода вырабатывает сигнал прерывания в следующих слу- 
чаях: 


С после выполнения команды ВЕАР РАТА (третья фаза); 
С после выполнения команды вЕАБ ОЕБЕТЕЬ БАТА (третья фаза); 
О после выполнения команды ВЕАР ТВАСК (третья фаза); 


Глава 11. Дисковая подсистема 403 


после выполнения команды ВЕАо тр (третья фаза); 


после выполнения команды ивтТЕ РАТА (третья фаза); 





после выполнения команды ивттЕ РЕБЕТЕО РАТА (третья фаза); 
после выполнения команды гОВвМАТ твАсСк (третья фаза); 
после выполнения команды зЕЕК; 


после выполнения команды вЕСАГТВВАТЕ, 


ооо ооо 


при передаче данных не в ОМА режиме. 


Таблица 11.46. Формат команды ЗЕМЗЕ ТМТЕВВИРТ 5ТАТО$ 





В результате выполнения команды зЕМЗЕ ТМТЕВВОРТ ЗТАТОИЗ будет возвра- 
щен байт состояния 5ТО0 (см. табл. 11.34). Причина прерывания и результат 
будут закодированы в битах [С (6 и 7) и ЗЕ (5). Если сигнал прерывания 
отсутствует, команда запишет в 5ТО значение вон. Рассмотрим пример для 
получения информации о прерывании, показанный в листинге 11.34. 





СеЕма1еТМТ ргос пеаг 


поу АЦ, 8 ; команда ЗЕМЗЕ ТМТЕВВОРТ $ТАТОЗ$ 
са11 ЗеВусеЕОО; записываем первый байт команды 
@гереаф: 


са11 СееВусеЕОр; записываем первый байт команды 
ап АТ, 80Б ; проверяем биты би 7 





спр АГ, 801 ; если прерывания нет 
3е @гереае ; повторяем опрос 
гее 


СеЕМа1еТМТ епар 


Аналогичный код для С++ приведен в листинге 11.35. 
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// пишем функцию для получения статуса прерывания 
у01а СебМащетмМтТ () 
{ 


ОИОВЬ @мВезо1Е = 0; // переменная для хранения результата 
116 1Т1ема1 = 50000; 
// команда ЗЕМЗЕ ТМТЕВВОРТ ЗТАТОЗ 
ЗеВуееЕЬр ( 0х08); 
// читаем порт ЗЕЗВ 
мр11е ( -- 1ТщеМмат® > 0) 
{ 
1оРогЕ ( 0ОхЗЕ5, &ЧмВезо1&, 1); 
// если прерывания есть, выходим из функции 
1Е ( ЧмВезо1е & 0х80) == 0х80) Ьгеак; 
// закончилось время ожидания 
1Е ( 1Трмема1е < 1) гебогп ЕВВОК Т1МЕ; 


11.2.2.10. Команда ЗЕМ$Е ОНУЕ $ТАТИ$ 


Эта команда позволяет получить информацию о состоянии дисковода. Раз- 
мер команды равен 1 байту. В третьей фазе возвращается 1 байт. Формат 
команды показан в табл. 11.47. 


Таблица 11.47. Формат команды 5ЕМЗЕ ОКТУЕ 5ТАТО$ 





11.2.2.11. Команда ЗЕЕК 


Данная команда позволяет переместить головки дисковода в заданную по- 
зицию (цилиндр). Размер команды равен 3 байта. После начала выполнения 
команды сравнивается заданное значение цилиндра МСМ с текущим РСМ. 
Если значения не совпадают, контроллер производит пошаговый поиск с 
проверкой результата после каждого шага. Формат команды показан в 
табл. 11.48. После выполнения данной команды следует вызвать 5ЗЕМЗЕ 
ТМТЕВВОРТ $ЗТАТО$ для получения результатов. 
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Таблица 11.48. Формат команды 5ЕЕК 







Первая 


Вторая 
фаза 


11.2.2.12. Команда РЕАО ЮР 


Команда позволяет получить текушую позицию головок дисковода. Размер 
команды равен 2 байта. Формат команды показан в табл. 11.49. 


Таблица 11.49. Команда ВЕАР Тр 








Первая 
фаза 


Третья 
фаза 


На этом завершим описание команд для флоппи-дисководов и перейдем к 
программированию устройств с интерфейсом АТА (АТ Анасптепе иеНасе) 
и АГАР! (АТ АиасНтепе ии РасКег Пиегасе ЕжепЯ оп). 


11.2.3. Устройства АТА/АТАР! 


Интерфейс АТАР! отличается от АТА способом передачи данных: запись и 
считывание информации происходят в пакетном режиме, похожим на рабо- 
ту устройств 5С5[. Интерфейс АТА позволяет управлять четырьмя дисково- 
дами, подключенными к контроллеру через два канала. На каждом канале 
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одно из устройств является ведущим (Оеусе 0), а другое — ведомым 
(Демсе 1). К устройствам АТА относятся в основном все современные же- 
сткие диски, а к АТАРТГ — такие устройства, как СО-КОМ, СО-В\, ОБУО- 
КОМ, ОУО-ВМ/ ит. п. 


Для работы с устройствами АТА и АТАР! существуют жестко закрепленные 
порты ввода-вывода и номера прерываний (табл. 11.50). 


Таблица 11.50. Доступ к устройствам АТА и АТАР! 








Дополнительные 
регистры 






120-—1Е7 (8 байт) ЗЕбь (1 байт) 






170-177 (8 байт) 376ъ (1 байт) 


Каждому каналу выделены собственные номера регистров. Назначение этих 
регистров описано в табл. 11.51. 


Таблица 11.51. Назначение регистров 








Использование регистра 


Чтение 


Регистр данных (ОА) 






Канал 1 

















11 Регистр ошибки (ЕВ) Регистр особенностей (ЕТ) 

ТЕ2В Регистр счетчика секторов | Регистр счетчика секторов ($С) 
($С) 

1ЕЗВ Регистр номера сектора Регистр номера сектора ($М№) 
($№) 

ТЕ4В Регистр младшего байта Регистр младшего байта номе- 
номера цилиндра (СЕ) ра цилиндра (СЕ) 

ТЕ5В Регистр старшего байта Регистр старшего байта номера 
номера цилиндра (СН) цилиндра (СН) 

ТЕбЬ Регистр выбора устройства _ 
и номера головки (ОН) 

1Е7В 


Регистр состояния (38) Регистр команд (СН) 


Дополнительный регистр Регистр управления (РС) 


состояния (АС) 





Как видно из таблицы, некоторые регистры имеют двойное назначение, 
в зависимости от выполняемой операции (запись или чтение). К сожалению, 
адресация СН$ последнее время не используется. Ее полностью заменил 
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режим логической адресации ВА. Для указания адреса сектора применяет- 
ся 28-разрядный адрес ВА. Исходя из этого, изменилось и назначение ре- 
гистров. В табл. 11.52 и 11.53 приводится новое назначение регистров для 
устройств АТА и АТАР?. 


Таблица 11.52. Назначение регистров для АТА 






Использование регистра 


Чтение 


Регистр данных (ОВ) 






Канал 1 





Запись 
















Регистр данных (ОВ) 








ТЕ Регистр ошибки (ЕН) Регистр особенностей (ЕТ) 
ТЕ2В Регистр счетчика секторов Регистр счетчика секторов 
($С) ($С) 

ЕЗВ Первый байт адреса (0-7) Первый байт адреса (0—7) 
ТРАВ Второй байт адреса (8—15) Второй байт адреса (8—15) 
ТЕ5Ь Третий байт адреса (16—23) | Третий байт адреса (16—23) 
1Е6В Регистр выбора устройства и | Регистр выбора устройства и 

4 бита ВА адреса (24—27) 4 бита [ВА адреса (24—27) 

Е7В Регистр состояния (ЗН) Регистр команд (СВ) 

ЗЕбВ 


Дополнительный регистр 
состояния (АС) 


Регистр управления устройст- 
вом (ОС) 


Таблица 11.53. Назначение регистров для АТАР! 











Использование регистра 


Чтение 


Регистр данных (ОА) 





Канал 1 





Запись 










Регистр данных (ОВ) 





1Е1В Регистр ошибки (ЕВ) Регистр особенностей (ЕТ) 
ТЕ2В Регистр прерывания — 
1ЕЗЬ — —_ 
ТРАВ Младший байт пакета данных | Младший байт пакета данных 
ТЕЗЬ Старший байт пакета данных | Старший байт пакета данных 
ТЕ6В Выбор устройства Выбор устройства 

Регистр состояния ($В) Регистр команд (СВ) 


Рассмотрим назначение каждого регистра подробнее. 
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11.2.3.1. Регистр данных 


Данный регистр используется для передачи данных в операциях чтения и 
записи. Это единственный из всех регистров, имеющий размер 16 бит, од- 
нако дополнительные 8 бит он "уводит" у регистра ошибок, перекрывая по- 
следний. При этом младший байт расположен в регистре 1хон, а старший — 
В 1х1. 


11.2.3.2. Регистр ошибки 


Регистр доступен для считывания и позволяет получить результат выпол- 
ненной операции. Формат регистра ошибки может меняться в зависимости 
от выполненной команды. Не изменяется только значение бита 2 ({АВВТ). 
Если он установлен в 1, значит, команда была прервана из-за ошибки. Про- 
верку этого регистра следует проводить только тогда, когда бит 0 (ЕКВ) 
в регистре состояния установлен в 1. Для устройств АТАРГ формат регистра 
показан в табл. 11.54. 


Таблица 11.54. Формат регистра ошибки для АТАР! 


Зепзе Кеу _- | АВВТ 









Описание 





Приведем краткое описание таблицы. 


С Бит 0, установленный в 1, означает, что указан неправильный размер па- 
кета команды или блока с данными. 


С Бит 1, установленный в 1, определяет, что найден конец носителя. 


О 


Бит 2, установленный в 1, означает, что команда была прервана из-за 
ошибки. 





С Биты 4—7 определяют значение ключа смысла, описывающего ошибку. 


11.2.3.3. Регистр особенностей 


Этот регистр доступен только для записи. Используется для выполнения 
различных установок и зависит от используемой команды. Для устройств 
АТАРТ формат регистра показан в табл. 11.55. 


Таблица 11.55. Формат регистра особенностей для АТАР! 





Описание 
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Приведем краткий комментарий к таблице. 
О Бит 0 управляет выбором режима передачи: 1 — ОМА, 0 — РО. 


С Бит 1 управляет выбором режима перекрытия команд: 1 — включен, 0 — 
выключен. 


11.2.3.4. Регистр счетчика секторов 


Данный регистр определяет общее количество секторов, которое будет запи- 
сано или считано. Регистр доступен для записи и чтения. При передаче оче- 
редного сектора значение в этом регистре уменьшается на 1, что позволяет 
контролировать число реально обработанных секторов. Для этого достаточ- 
но прочитать значение из регистра. 


11.2.3.5. Регистр прерывания 


Регистр позволяет определить различную информацию о состоянии преры- 
вания. Доступен только для чтения. Бит 0 (С/О) определяет тип данных 
(1 — управляющая команда, 0 — пользовательские данные). Бит 1 (МО) ука- 
зывает направление передачи данных (| — от устройства к компьютеру, 0 — 
от компьютера к устройству). Бит 2 (ВЕ) помогает определить, свободна ли 
шина (1 — шина свободна). 


11.2.3.6. Регистр номера сектора 


Этот регистр позволяет установить начальный сектор для операций записи 
или считывания. Доступен для записи и чтения. При использовании логиче- 
ской адресации содержит младший байт адреса (0—7). 


11.2.3.7. Регистр младшего байта номера цилиндра 


Регистр позволяет установить начальный номер цилиндра (младший байт). 
Доступен для записи и чтения. При использовании логической адресации 
содержит второй байт адреса (8—15). 


11.2.3.8. Регистр старшего байта номера цилиндра 


Ланный регистр позволяет установить начальный номер цилиндра (старший 
байт). Доступен для записи и чтения. При использовании логической адре- 
сации содержит второй байт адреса (16—23). 


11.2.3.9. Регистр выбора устройства и номера головки 


Регистр позволяет выбрать номер устройства (0 или 1), а также дополни- 
тельные параметры в зависимости от режима адресации. Формат регистра 
показан в табл. 11.56. 
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Таблица 11.56. Формат регистра выбора устройства 





Описание 


Приведем краткое описание таблицы. 


С Биты 0—3 должны определять номер головки при использовании СР5- 
адресации. В режиме 1.ВА они должны определять четыре старших раз- 
ряда адреса (24—27): 0 — 24, 1 — 25, 2 — 26и3 — 27. 


С Бит 4 позволяет выбрать номер устройства на канале: | — ведущее (Маз- 
ег), 0 — ведомое (З1ауе). 


С Бит 5 устарел. Может быть установлен в 1 для совместимости со старыми 
стандартами. 


О 


Бит 6 позволяет выбрать режим адресации: 0 — СН$, 1 — 1ВА. 





С Бит 7 устарел. Может быть установлен в 1 для совместимости со старыми 
стандартами. 


11.2.3.10. Регистр состояния 

Регистр позволяет получить текущее состояние устройства. Доступен только 
для чтения. Если бит 7 установлен в 1, содержание регистра игнорируется. 
Формат регистра показан в табл. 11.57. 


Таблица 11.57. Формат регистра состояния 


Биты 


Описание 





Приведем краткое описание таблицы. 


С Бит 0, установленный в 1, означает, что произошла ошибка при выпол- 
нении команды. Для устройств АТАР[Г этот бит называется СНК. 


С Биты 1-2 устарели и не должны использоваться. 


С Бит 3, установленный в 1, определяет, что устройство готово к передаче 
данных. 


С Бит 4 может менять свое назначение в зависимости от выполняемой 
команды. 


С Бит 5, установленный в 1, означает, что произошла неизвестная ошибка, 
например аппаратный сбой устройства. 
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О Бит 6 равен 1, когда устройство может выполнить любую поддерживае- 
мую команду. 


О Бит 7, установленный в 1, означает, что устройство занято. 


11.2.3.11. Регистр команд 


Данный регистр позволяет передать устройству определенную команду. Дос- 
тупен только для записи. Запись команды должна производиться, когда 
очищены биты ВЗУ и ОКО в регистре состояния. Выполнение команды на- 
чинается сразу после записи в этот регистр, поэтому если команда имеет 
дополнительные параметры, вначале следует записать их в соответствующие 
регистры. 


11.2.3.12. Дополнительный регистр состояния 


Регистр содержит ту же информацию, что и регистр состояния. Доступен 
только для чтения. Если бит 7 установлен в 1, содержание регистра игнори- 
руется. Чтение регистра не сбрасывает сигнал прерывания. 


11.2.3.13. Регистр управления 


Этот регистр позволяет управлять программным сбросом устройств и сигна- 
лом прерывания. Доступен только для записи. Любые изменения в регистре 
сразу же вступают в силу. Формат регистра показан в табл. 11.58. 


Таблица 11.58. Формат регистра состояния 


ев [а 82| 


Приведем краткое описание таблицы. 





Описание 





П Бит 0 должен быть установлен в 0. 
С Бит 1 управляет сигналом прерывания: 1 — запрещен, 0 — разрешен. 
С Бит 2 управляет программным сбросом устройств: 1 — выполнить сброс. 


С Бит 7 является старшим разрядом для 48-разрядного адреса набора осо- 
бенностей. Запись любого значения в регистр команд очищает этот бит. 


Теперь, когда мы разобрались с имеющимися регистрами, пора познако- 
миться с управляющими командами. Все команды можно разделить на две 
группы: обычные и пакетные. К последней группе также можно отнести на- 
бор команд $С$1 (Миитефа Соттап4$). Здесь мы рассмотрим только 
команды АТА/АТАРИ, а с набором команд 5С$ЗЕ вы можете познакомиться 
в книге [3]. 
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11.2.4. Команды управления 
для устройств АТА/АТАР! 


Обычные команды могут быть трех видов: обязательные для всех устройств, 
необязательные и определяемые производителем. Список команд для ин- 
терфейса АТА/АТАР1-7 представлен в табл. 11.59. 


Таблица 11.59. Список команд АТА/АТАР]-7 





Имя команды Код Поддержка 

СГА ЕВАЗЕ ЗЕСТОВ$ сон Необязательная 

СЕА ВЕОЦЕЗТ ЕХТЕМРЕР ЕВВОВ озв Необязательная 

СЕА ТВАМЗЬАТЕ ЗЕСТОВ 875 Необязательная 

СЕА ИВТТЕ МОБТТРЬЕ ИТТНООТ ЕВАЗЕ срь Необязательная 

СЕА МВТТЕ ЗЕСТОВ$ ИТТНОЙТ ЕВАЗЕ 38Н Необязательная 
СНЕСК МЕРТА САВОЬ ТУРЕ 21В Необязательная 
СНЕСК РОМЕВ МОБЕ ЕБИ Обязательная 
СОМЕТСИВЕ ЗТВЕАМ 518 Необязательная 
РЕУТСЕ СОМЕТСОВАТТОМ ЕВЕЕЗЕ РОСК ВВ Необязательная 
РЕУТСЕ СОМЕТСОВАТТОМ ТРЕМТТЕУ Вв11 Необязательная 
РЕУТСЕ СОМЕТСОВАТТОМ ВЕЗТОВЕ В1В Необязательная 
РЕУТСЕ СОМЕТСОВАТТОМ ЗЕТ В Необязательная 
РЕУТСЕ ВЕЗЕТ 083 Обязательная для АТАР! 
РОИМЬОАВ МТСВОСОБЕ 92. Необязательная 
ЕХЕСОТЕ ОРЕУТСЕ ОТАСМОЗТТС 905 Обязательная 

ЕБОЗН САСНЕ Е7Ь Обязательная для АТА 
ЕЬОЗН САСНЕ ЕХТ БАБ Необязательная 

СЕТ МЕОТА ЗТАТОЗ РАВ Необязательная 
ТОЕМТТРУ ОЕУТСЕ ЕСВ Обязательная для АТА 
ТРЕМТТЕУ РАСКЕТ РЕУТСЕ А1П Обязательная для АТАР! 
ТОЬЕ ЕЗВ Обязательная для АТА 
ТОГЕ ТММЕОТАТЕ 61 Обязательная 

МЕОТА ЕЗЕСТ ЕО Необязательная 
МЕОТА ГОСК ЕВ Необязательная 


МЕРТА ОМЬОСК РЕБ Необязательная 
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Таблица 11.59 (продолжение) 








Имя команды Код Поддержка 

МОР о0з Обязательная для АТАР! 
РАСКЕТ АОН Обязательная для АТАР] 
ВЕАР ВОЕЕЕВ ЕАН Необязательная 

ВЕАР ОМА с8п Обязательная для АТА 
ВЕАР ОМА ЕХТ 258 Необязательная 

ВЕАР РМА ОЧЕОЕР С7ы Необязательная 

ВЕАР ОМА ООБОЕО ЕХТ 261 Необязательная 

ВЕАР Об ЕХТ 2ЕВ Необязательная 

ВЕАР МОГТТРЬЕ Сав Обязательная для АТА 
ВЕАР МОБТТРЬЕ ЕХТ 291 Необязательная 

ВЕАР МАТТУЕ МАХ АООВЕ$5 Е8Н Необязательная 

ВЕАР МАТТУЕ МАХ АБОВЕ$$ ЕХТ 278 Необязательная 

ВЕАР ЗЕСТОВ($) 208 Обязательная 

ВЕАО ЗЕСТОВ(5) ЕХТ 24В Необязательная 

ВЕАР ЗТВЕАМ ОМА 2АВ Необязательная 

ВЕАР ЗТВЕАМ РТО 2ВВ Необязательная 

ВЕАР УЕВТЕУ ЗЕСТОВ ($) 405 Обязательная для АТА 
ВЕАР УЕВТЕУ ЗЕСТОВ(5$) ЕХТ 421 Необязательная 
ЗЕСОВТТУ ОТЗАВЬЕ РАЗЗМОВО Ебз Необязательная 
ЗЕСОВТТУ ЕВАЗЕ РВЕРАВЕ ЕЗЬ Необязательная 
ЗЕСОВТТУ ЕВАЗЕ ОМТТ Е4В Необязательная 
ЗЕСОВТТУ ЕВЕЕРЕ РОСК Р5В Необязательная 
ЗЕСОВТТУ 5ЕТ РАЗЗИОВО Е Необязательная 
ЗЕСОВТТУ ОМЬОСК Е2В Необязательная 
ЗЕВУТСЕ А2В Необязательная 

ЗЕТ ЕЕАТОВЕЗ$ ЕЕН Обязательная 

ЗЕТ МАХ АОРВЕ$$ Е Необязательная 

СЕТ МАХ АШОВЕ$$ ЕХТ 37 Необязательная 

ЗЕТ МОБТТРЬЕ МОБЕ с6н Обязательная для АТА 
ЗЬЕЕР ЕбЪ Обязательная 


ЗМАВТ ОТЗАВЬЕ ОРЕВАТТОМ$ вон Необязательная 
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Таблица 11.59 (окончание) 








Имя команды Код Поддержка 

ЗМАВТ ЕМАВЬЕ/РТЗАВЬЕ АОТОЗАУЕ вон Необязательная 
ЗМАВТ ЕМАВЬЕ ОРЕВАТТОМ$ вов Необязательная 
ЗМАВТ ЕХЕСОТЕ ОКЕ ТТМЕ ТММЕОТАТЕ вон Необязательная 
ЗМАВТ ВЕАО РАТА вов Необязательная 
ЗМАВТ ВЕАР Об вов Необязательная 
ЗМАВТ ВЕТОВМ $ТАТОЗ вов Необязательная 
ЗМАВТ ИВТТЕ №06 вов Необязательная 
ЗТАМОВУ Е2В Обязательная для АТА 
ЗТАМОВУ ТММЕОТАТЕ ЕО Обязательная 

ИВТТЕ ВОЕЕЕВ Е8В Необязательная 
ИВТТЕ ОМА САБ Обязательная для АТА 
ИВТТЕ ОМА ЕХТ 355 Необязательная 
ИВТТЕ ОМА ЕОА ЕХТ Зрв Необязательная 
ИВТТЕ ОМА ООЕОЕР ССВ Необязательная 
ИВТТЕ ОМА ООБОЕО ЕХТ Зея Необязательная 
ИВТТЕ ОМА ООЕОЕР ЕРУА ЕХТ ЗЕВ Необязательная 
ИВТТЕ ЬОб ЕХТ ЗЕЬ Необязательная 
ИВТТЕ МОБТТРЬЕ С55 Обязательная для АТА 
ИВТТЕ МОБТТРЬЕ ЕХТ 395 Необязательная 
ИВТТЕ МОГТТРЬЕ ЕОА ЕХТ СЕБ Необязательная 
ИВТТЕ ЗЕСТОВ ($5) зов Обязательная для АТА 
ИВТТЕ ЗЕСТОВ($) ЕХТ Зав Необязательная 
ИВТТЕ ЗТВЕАМ РМА ЗАВ Необязательная 
ИВТТЕ ЗТВЕАМ РТО ЗВВ Необязательная 





Мы не будем рассматривать все имеющиеся команды, а разберем только 
обязательные для всех устройств. 


11.2.4.1. Команда СНЕСК РОМЕР МОБЕ 


Эта команда предназначена для получения информации о питании устрой- 
ства. Команда является обязательной для обычных и пакетных устройств. 
Формат команды показан в табл. 11.60. 
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Таблица 11.60. Формат команды СНЕСК РОМЕК МОРЕ 










Регистры 









Не используется 


1х28 Не используется 
1х35 Не используется 
1х4ав Не используется 
1х5. 


Не используется 


Е5Ь 









Для инициализации команды следует в регистр 1х6ь записать номер устрой- 
ства ОЕМ (0 или 1), а затем в регистр 1х7н записать код команды ЕН. При 
успешном выполнении регистры будут содержать следующую информацию: 


1. Регистр 1х2ь будет хранить результат команды: 005 — дежурный режим 
(Зцапдбу), вов — режим простоя (194е), ЕЕь — режим простоя (е) или 
активный (АсИуе) режим. 


2. Регистр 1хбн будет хранить номер выбранного устройства. 


3. Регистр 1х7п будет иметь вид: В$\У = 0, ОВО\Х = 1, ОЕ =0, ОКО =0ди 
ЕВК = 0. 


В случае ошибки регистры будут иметь следующий вид: 


1. В регистре 1х1ь бит АВВТ будет установлен в 1, если устройство не под- 
держивает команду или произошло аварийное завершение. 


2. Регистр 1хбь будет хранить номер выбранного устройства. 


3. Регистр 1х7ь будет иметь вид: ВЗУ =0, ОКОУ =1, ОЕ =] (при сбое 
устройства), ОКО =Ои ЕКК = 1. 


Например, чтобы проверить состояние питания для жесткого диска на пер- 
вом канале, можно использовать код из листинга 11.36. 





; ждем готовности устройства 
ТзВеаЧАТА ргос пеак 

поу ОХ, 1Е7Ь ; указываем порт 
@гереас: 

11 АБ, ОХ ; читаем порт состояния 
{езё АГ, 806 ; проверяем бит 7 
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707 @гереак ; если бит 7 равен 1, повторяем 
ге 

ТзВеаЧАТА епар 

; наш код 

са11 ТзВеааАТА; ждем, пока порт освободится 
Чес ОХ ; порт 1ТЕ6В 

поу АБ, ОАОБ ; первое устройство на первом канале 
оЧе Ох, АБ ; записываем значение в порт 

1пс ЭХ ; порт 1Е7В 

моу АГ, ОЕЗЬ ; код команды СНЕСК РОМЕК МОБЕ 
оп ОХ, АБ ; записываем значение в порт 

са11 ТзВеааАТА; ждем, пока порт освободится 

р АГ, ОХ ; читаем регистр статуса 

сезЕе АЪ, 016 ; если ошибка 

12 ЕВКОК НМО; передаем управление обработчику 
са11 ТзВеааАТА; ждем, пока порт освободится 
мох ОХ, 1Е21 ; выбираем регистр с результатом операции 
11 АБ, ВХ ; читаем значение 

спр АЪ, 0 ; дежурный режим ? 

)е ЗТАМОВУ МОРЕ 

сир АГ, 80Н ; режим простоя ? 

)е ТРБЕ МОРЕ 

стр АГ, РЕЕр ; неопределенный режим ? 

)е АСТТУЕ_ МОРЕ 


Аналогичный пример для С++ показан в листинге 11.37. 





Листинг 11.37. Проверка состояния питания жесткого диска в С++ 
// пишем функцию для ожидания готовности устройства 
у01Я ТзВеаЧУАТА () 
{ 
РИОВР ЯмВез11е = 0; // переменная для хранения результата 
106 1ТаеИа1® = 50000; 
// читаем порт 1Е7В 
\р11е ( -- 1Т1мейале > 0) 
{ 
1пРогЕ ( 0х1Е7, &9мВезо16, 1); 
// если бит 7 равен 0, выходим 
1Е ( ЗмВезо1 & 0х80) == 0х00) Бгеак; 
// закончилось время ожидания 
1Е ( 1Тамейа1е < 1) гебагпт ЕВВОВ _ТТМЕ; 
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// получаем состояние питания 
1р0Е СееРометМоае () 
{ 
РИОВР ЯмВез11Е = 0; // переменная для хранения результата 
Т5ВеаЧУуАТА (); // ждем, пока порт освободится 
ООЕРОГЕ ( 0х1Е6, ОхАО, 1); // первое устройство на первом канале 
ОЧЕРогЕ ( 0х1Е7, 0хЕ5, 1); // код команды СНЕСК РОМЕВ МОРЕ 
ТзВеаДуАТА (); // ждем, пока порт освободится 
1пРОКЕ ( 0х1Е7, &ЧмВезо1&, 1); // читаем регистр статуса 
1Е ( ( амвезо1е & 0х01) == 0х01) // произошла ошибка 
кебаги -1; 
ТзВеаЧуАТА (); // ждем, пока порт освободится 
1пРОЕКЕ ( 0х1Е2, &ЧмВезо1Е, 1); // выбираем регистр 
// с результатом операции 
зм1ЕсВ ( амВези1е) 
{ 
сазе 0: // дежурный режим 
гебсагп 1; 
сазе 128: // режим простоя 
гебатп 2; 
сазе 256: // активный или простой 
гесагп 3; 


11.2.4.2. Команда РЕМСЕ РЕЗЕТ 


Команда позволяет выполнить сброс выбранного устройства на шине. Ис- 
пользуется только для АТАР|-устройств. Формат команды показан в табл. 11.6]. 


Таблица 11.61. Формат команды рЕУТСЕ ВЕЗЕТ 







Не используется 


1х28 Не используется 
1х3 Не используется 
1х4в Не используется 


Не используется 


08Н 
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Для инициализации команды следует в регистр 1х6н записать номер устрой- 
ства ОЕУ (0 или 1), а затем в регистр 1х7в записать код команды о8н. При 
успешном выполнении регистры будут содержать следующую информацию: 


1. В регистр 1х1ь будет помещен диагностический код (табл. 11.62). 
2. В регистры 1х2.—1х6н будет записана сигнатура (табл. 11.63). 


3. В регистр 1х7ь будет записана информация в соответствии с протоколом 
команды. 


Таблица 11.62. Диагностические коды 


Код Описание 


Первое устройство (Бемсе 0} 





отв Де\мсе 0 выполнило команду, Оемсе 1 выполнило команду 
или отсутствует 

ООН, 026-—ТЕБ Сбой в устройстве Ве\мсе 0, Оемсе 1 выполнило команду 
или отсутствует 

818 Ое\мсе 0 выполнило команду, сбой в устройстве Ое\мсе 1 

80Н, 821-—РЕБ Сбой в обоих устройствах 





Второе устройство (Бемсе 1} 





018 Деусе 1 выполнило команду 


008. 02н-—7ЕЬ Сбой в устройстве Ое\мсе 1 





Таблица 11.63. Значения для сигнатуры 


Регистры АТАР! 
15х28 о1в 
1х3В о1в 
1хав 146 
1х58 ЕВЬ 
1х6в обл (Ремсе 0) или тов (Вемсе 1) 





11.2.4.3. Команда ЕХЕСОТЕ ОЕМСЕ ОГАСМО$ ТИС 


Данная команда позволяет выполнить диагностику устройства для опреде- 
ления его работоспособности. Выполняется для всех подключенных уст- 
ройств. Формат команды показан в табл. 11.64. 
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Таблица 11.64. Формат команды ЕХЕСОТЕ РЕУТСЕ РТАСМОЗТТС 














Не используется 

х2В Не используется 

1х3 Не используется 

хав Не используется 

1х56 Не используется 

хбп Не используется 
ов 








Для инициализации команды следует в регистр 1х7ь записать код коман- 
ды 905. При успешном выполнении регистры будут содержать следующую 
информацию: 


1. В регистр 1х1 будет помещен диагностический код (см. табл. 11.62). 
2. В регистры 1х2.—1х6н будет записана сигнатура (см. табл. 11.63). 


3. В регистр 1х7ь будет записана информация в соответствии с протоколом 
команды. 


11.2.4.4. Команда ЕЕУ$Н САСНЕ 


Эта команда позволяет сбросить кэш на диск. Является обязательной для 
всех устройств АТА. Для полного завершения операции команде может по- 
налобиться больше полминуты. Формат команды показан в табл. 11.65. 


Таблица 11.65. Формат команды ЕТИЗН САСНЕ 






Регистры 









Не используется 


1х2В Не используется 
1;38 Не используется 
1хаВ 


Не используется 


Не используется 


Е7ЬВ 
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Для инициализации команды следует в регистр 1х6ъ записать номер устрой- 

ства РЕУ (0 или 1), а затем в регистр 1х7. записать код команды Е?7ь. При 

успешном выполнении регистры будут содержать следующую информацию: 

1. Регистр 1х6в будет хранить номер выбранного устройства. 

2. Регистр 1х7 будет иметь вид: ВЗУ = 0, РКОУ = 1, РЕ =0, ОВО =0и 
ЕКК = 0. 

В случае ошибки регистры будут иметь следующий вид: 


1. В регистре 1х1ль бит АВЕТ будет установлен в 1, если устройство не под- 
держивает команду или произошло аварийное завершение. 


2. Регистр 1хзь будет хранить ГВА адрес сектора (0—7), на котором про- 
изошла ошибка. 


3. Регистр 1х4в будет хранить [.ВА адрес сектора (8—15), на котором про- 
изошла ошибка. 


4. Регистр 1х5 будет хранить Т.ВА адрес сектора (16—23), на котором про- 
изошла ошибка. 


5. Регистр 1х6ь будет хранить номер устройства (бит 4) и 1.ВА адрес сектора 
в битах 0—3 (24—27). 


6. Регистр 1х7н будет иметь вид: ВЗУ = 0, ОКОУ = 1, РЕ=1 (при сбое 
устройства), ОКО = ОиЕКК = 1. 


11.2.4.5. Команда /РЕМПРЕУ ОЕУИСЕ 


Эта команда позволяет получить различную информацию об устройстве. 
Является обязательной для всех устройств АТА. Формат команды показан 
в табл. 11.66. 


Таблица 11.66. Формат команды трЕМТТЕУ РЕУТСЕ 







Регистры 


Не используется 








1х2В Не используется 
1х3В Не используется 
1х4аВ 


Не используется 


Не используется 


ЕСВ 





Резерв 





Глава 11. Дисковая подсистема 421 


Для инициализации команды слбдует в регистр 1х6ъ записать номер устрой- 
ства ОЕУ (0 или 1), а затем в регистр 1х7ь записать код команды Есь. При 
успешном выполнении регистры будут содержать следующую информацию: 


1. Регистр 1х6ь будет хранить номер выбранного устройства. 
2. Регистр 1х7ъ будет иметь вид: ВЗУ = 0, ОВБУ = 1, БЕ =0, ОКО =0и 
ЕВК = 0. 


После выполнения команды устройство возвращает через регистр данных 
256 слов (по 16 битов), описывающих параметры дисковода. Все зарезерви- 
рованные биты и слова установлены в 0. Формат возвращаемых данных 
представлен в табл. 11.67. 


Таблица 11.67. Формат данных для команды треМТТРУ ОБУТСЕ 


Смещение Описание 
слова 
0 Конфигурация устройства: 15 — тип интерфейса (0 — АТА), 14—8 не 
используются, 7 — тип устройства (1 — со сменным носителем), 6—3 
не используются, 2 — неполные данные (1 — получены не все возмож- 
ные данные), 1 не используется, 0 зарезервирован 
1 Устарел 
2 Определяется производителем 
3—6 Устарели 
7—8 Зарезервированы 
9 Не используется 
10—19 Серийный номер устройства (содержит 20 АЗС!-символов) 
20—21 Не используются 
22 Устарел 
23—26 Номер версии (содержит 8 АЗС!-символов) 


27—46 Номер модели (содержит 40 АЗСИ-символов) 


47 Биты 15—8 установлены в 805, а биты 7—0 определяют максимальное 
число для команд многоблочного чтения и записи (011—ЕЕВ) 

48 Зарезервирован 

49 Поддерживаемые возможности: 15—14 — резерв, 13— управление 


таймером для З{апаБу (1 — поддержка в АТА есть, О — таймером 
должно управлять устройство), 12 — резерв, 11 — поддержка сигнала 
ЮВОУ (0 — есть, 1 — нет), 10 — состояние сигнала 1ОВОУ (1 — выклю- 
чен), 9 — поддержка 1ВА (1 — есть), 8 — поддержка ОМА (1 — есть}, 
7—0 не используются 
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Смещение 
слова 


50 


51—52 
53 


54—58 
59 


60—61 
62 
63 


64 
65 


66 


67 
68 


69—79 
80 


81 
82 
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Таблица 11.67 (продолжение) 


Описание 


Поддерживаемые возможности: бит 15 равен 0, бит 14 равен 1, 
13—2 — резерв, 1 — устарел, 0 — равен 1 для индикации минимально- 
го значения таймера З{4апаБу 


Устарели 


Состав: 15-3 зарезервированы, 2 — допустимость слова 88 (1 — поле 
со смещением 88 допустимо}, 1 — слов 64—70 (1 — допустимы), 0 — 
устарел 


Устарели 


Состав: 15-9 — резерв, 8 — настройка многоблочной передачи секто- 
ров (1— допустима), 7—0 — текущее значение числа секторов для 
многоблочной передачи 


Полное количество секторов, адресуемых пользователем 
Устарел 


Состав: 15—11 — резерв, 10 — режим Ми\мюога ОМА 2 (1 — выбран), 
9 — режим Ми&мога ОМА 1 (1 — выбран), 7—3 — резерв, 2 — поддерж- 
ка режима Мийёмога ОМА2 (1— есть), 1— поддержка режима 
Ми \мога ОМА 1 (1-— есть), 0 — поддержка режима Ми \мога ОМА 0 
(1 — есть) 


Состав: 15—8 — резерв, 7—0 — поддержка режимов РЮ 


Минимальное время передачи для режима Ми!мюога ОМА в наносе- 
кундах 


Рекомендуемое производителем время передачи для режима Мийн- 
мога ОМА в наносекундах 


`Минимальное время передачи для режима РО в наносекундах 


Минимальное время передачи для режима РЮ с ЮНОУ в наносекун- 
дах 


Необязательные и зарезервированные поля 


Главный (та]ог}) номер версии интерфейса: 15—8 — резерв, 7 — под- 
держка версии АТА/АТАР!-7 (1— есть), 6— поддержка версии 
АТА/АТАР1-6 (1 — есть), 5 — поддержка версии АТА/АТАР!-5 (1 — есть}, 
4 — поддержка версии АТА/АТАР!-4 (1 — есть), 3 — поддержка версии 
АТА/АТАР!-3 (1 — есть}, 2—1 устарели, 0 — резерв 


Дополнительный (ттог) номер версии интерфейса 


Поддержка команд: 15 устарел, 14— команда мор (1— есть}, 13 — 
команда вЕАБ ВОЕЕЕВ (1 — есть}, 12 — команда ивттЕ ВОЕЕЕВ (1 — 
есть}, 11 устарел, 10 — защищенная область хоста (1 — есть), 9 — 
команда РЕУТСЕ ВЕЗЕТ (1 — есть}, 8 — прерывание ЗЕАМСЕ (1 — есть}, 
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Смещение 
слова 


(прод.) 


83 


84 


85 


86 


Таблица 11.67 (продолжение) 


Описание 


7 — прерывание при освобождении шины (1 — есть}, 6 — упреждение 
(1 — есть}, 5 — кэширование записи (1 — есть}, 4 — поддержка пакет- 
ных команд (0 — есть}, 3 — управление питанием (1 — есть), 2 — под- 
держка команд для сменных носителей (1— есть), 1 — поддержка 
команд секретности (1 -— есть}, О— поддержка команд Зтай (1 — 
есть 


Поддержка команд: 15—14 равны 0, 13 — команда ЕТОЗН САСНЕ ЕХТ 
(1 — еств), 12 — команда гкьозн САСНЕ (1 — есть}, 11 — набор команд 
конфигурации (1 — есть), 10 — 48-битная адресация (1 — есть}, 9— 
автоматическое управление для акустики (1 — есть), 8 — зЕт мах (1 — 
есть}, 7— резерв, 6 — зЕТ РЕАТОВЕЗ (1 — есть}, 5 — подача питания в 
режиме З{апаБу (1 — есть), 4 — уведомления для сменных носителей 
(0 — есть), 3— расширенное управление питанием (1 — есть}, 2— 
поддержка команд СРА (1 — есть}, 1 — ВЕАР/ИВТТЕ ОМА ОЧЕОЕР (1 — 
есть}, 0 — роимгодр мтсвосорЕ (1 — есть} 


Поддержка команд: 15—14 равны 0, 13 — резерв, 12 — ограничение по 
времени для записи и чтения непрерывно (1 — есть), 11 — ограниче- 
ние по времени для записи и чтения (1 — есть}, 10 — бит ОВС для ко- 
манд ивттЕ ЗТВЕАМ ОМА И ИВТТЕ ЗТВЕАМ РТО (1 — есть}, 9 — бит УВ@ 
для команд ВЕАР ЗТВЕАМ ОМА И ВЕАС ЗТВЕАМ РТО (1 — есть}, 8 — уни- 
кальные имена (1 — есть), 7 — команда ивтТЕ ОМА ОЧЕОЕР КИА ЕХТ 
(1 — есть), 6— ивттЕ ОМА КУА ЕХТ И ИВТТЕ МОГТТРЬЕ РУА ЕХТ (1 — 
есть), 5 — набор свойств регистрации (1 — есть}, 4 — набор потоковых 
свойств (1 — есть), 3 — Меда Сага (1 — есть}, 2 — серийный номер для 
МеЧа Сага (1 — есть), 1 — самотестирование ЗМАНТ (1 — есть), 0 — 
отчет об ошибках для ЗМАНТ (1 - есть} 


Установка набора команд или свойств: 15 устарел, 14 — команда мор 
(1 — включить), 13— ВЕАР ВОЕЕЕВ (1 — включить}, 12 — ИВТТЕ ВОЕЕЕВ 
(1 — включить}, 11 устарел, 10 — защищенная область хоста (1 — 
включить}, 9 — рЕУТСЕ ВЕЗЕТ (1 — включить), 8 — прерывание ЗЕВМУСЕ 
(1 — включить), 7 — освобождение шины (1 — включить}, 6 — упрежде- 
ние (1 — включить}, 5 — кэширование записи (1 — включить}, 4 — уп- 
реждение (1 — включить), 3 — управление питанием (1 — включить}, 
2— работа со сменными носителями (1 — включить), 1 — набор ко- 
манд секретности (1 — включить), О— набор команд ЗМАВТ (1— 
включить} ° 


Установка набора команд или свойств: биты 15—14 — резерв, 13— 
команда ЕЪОЗН САСНЕ ЕХт (1 — включить), 12 — команда ЕТОЗН САСНЕ 
(1— включить}, 11— набор команд конфигурации (1 — включить), 
10 — 48-битная адресация (1 — включить), 9 — автоматическое управ- 
ление для акустики (1 — включить), 8 — зЕТ мах (1 — включить), 7 — 
резерв, 6 — зЕт ГЕАТИВЕЗ (1 — включить), 5 — подача питания в режи- 
ме З{апаБу (1 — включить}, 4 — уведомления для сменных носителей 
(0 — включить), З3— расширенное управление питанием (1 — вклю- 
чить), 2 — поддержка команд СРА (1 — включить), 1 — ВЕАО/ИВТТЕ РМА 
ООЕОЕР (1 — включить}, 0 — роимьодр МТСВОСОБЕ (1 — включить} 
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Таблица 11.67 (окончание) 


Смещение 


писание 
слова о 


87 Установка набора команд или свойств: 15 бит равен 0, 14 бит равен 0, 
13 — резерв, 12 — ограничение по времени для записи и чтения не- 
прерывно (1 — включить), 11 — ограничение по времени для записи и 
чтения (1 — включить}, 10 — бит ИВС для команд ИВТТЕ ЗТВЕАМ ОМА и 
ИВТТЕ ЗТВЕАМ РТО (1 — включить), 9 — бит ОВО для команд ВЕАО 
ЗТВЕАМ ОМА И ВЕАО ЗТВЕАМ РТО (1 — включить}, 8 — уникальные имена 
(1 — включить), 7 — команда ивтТЕ ОМА ОЧЕОЕР ЕОА ЕХт (1 — вклю- 
чить}, 6 — ивтТЕ ОМА РОА ЕХТ И ИВТТЕ МОБТТРЬЕ ЕОА ЕхХТ (1 — вклю- 
чить), 5 — набор свойств регистрации (1 — включить), 4 — набор пото- 
ковых свойств (1 — включить}, 3— Мефа Сага (1 — включить), 2— 
серийный номер для Мефа Сага (1 — включить), 1 — самотестирова- 
ние ЗМАВТ (1 — включить}, 0 — отчет об ошибках для ЗМАВТ (1— 
включить} 


88—254 Необязательные параметры 


255 Контрольное слово: 8—15 — контрольная сумма, 0—7 — сигнатура 
(АБН) 


11.2.4.6. Команда ГРЕМТ/РУ РАСКЕТ БЕУ!СЕ 


Эта команда позволяет получить различную информацию о пакетном уст- 
ройстве. Является обязательной для всех устройств АТАРТ. Формат команды 
показан в табл. 11.68. 


Таблица 11.68. Формат команды ТрЕМТТЕУ РАСКЕТ РЕУТСЕ 


Биты 
Регистры 
ЕСС ОЕ Е ОЕ ОНИ И 
1х1 Не используется 
1х28 Не используется 
1х3Н Не используется 
1х4В Не используется 
1х5В Не используется 
1х78 А1В 


Для инициализации команды следует в регистр 1х6ь записать номер устрой- 
ства ОЕУ (0 или 1), а затем в регистр 1х7н записать код команды Есь. 
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При успешном выполнении регистры будут содержать следующую инфор- 
мацию: 


1. Регистр 1к6в будет хранить номер выбранного устройства. 


2. Регистр 1х7ь будет иметь вид: ВУ = 0, ОКУ = 1, РЕ =0, ОКО =0и 
ЕВК = 0. 


После выполнения команды устройство возвращает через регистр данных 
256 слов (по 16 битов), описывающих параметры дисковода. Все зарезерви- 
рованные биты и слова будут установлены в 0. Формат возвращаемых дан- 
ных представлен в табл. 11.69. 


Таблица 11.69. Формат данных для команды трЕМТТЕУ РАСКЕТ БЕУТСЕ 


Смещение 


Описание 
слова 


0 Конфигурация устройства: 15—14 — тип интерфейса (10ь — АТАР!}, 13 — 
резерв, 12—8 — тип устройства (005 — устройство прямого доступа, 
01 — устройство последовательного доступа, 025 — принтер, озь — про- 
цессор, олп — устройство с однократной записью, 051 — СО-ВОМ, о6ъ — 
сканер, 1=ъ — неизвестный тип устройства), 7 — устройство поддержива- 
ет сменные носители (1— да}, 6—5 — время установки сигнала ОВО 
(005 — через З мс после приема команды, 10ъ — через 50 мкс после 
приема команды), 4—3 — резерв, 2 — неполные данные (1 — получены не 
все возможные данные} 1—0— поддерживаемый размер пакетной 
команды (00ъ — 12 байт, о1ь — 16 байт} 


.1—9 Зарезервированы 

10—19 — Серийный номер устройства (содержит 20 АЗС!-символов) 
20—22 Не используются 

23—26 Номер версии (содержит 8 АЗС!-символов) 

27—46 — Номер модели (содержит 40 АЗСИ-символов) 

47—48 Зарезервированы 


49 Поддерживаемые возможности: 15 — чередование для ОМА (1 — есть}, 
14 — очередь команд (1 — есть), 13— перекрытие команд (1 — есть}, 
12 — программный сброс (устарел}, 11 — поддержка сигнала ОРОХ (0 — 
есть, 1 — нет), 10 — блокировка сигнала 1ОВОУ (1 — есть), 9 равен 1, 8 — 
поддержка ОМА (1 — есть}, 7—0 не используются 


50—52 Зарезервированы 


53 Состав: 15—3 зарезервированы, 2 — допустимость слова 88 (1 — поле со 
смещением 88 допустимо), 1 — слов 64—70 (1 — допустимы), 0 — уста- 
рел 


54—62 Зарезервированы 
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Таблица 11.69 (продолжение) 





Смещение 
слова 


63 


83—84 


86—87 


Описание 


Состав: 15—11 резерв, 10 — режим Мий\мога ОМА 2 (1 — выбран), 9 — 
режим Ми\мога ОМА 1 (1 — выбран}, 7—3 — резерв, 2 — поддержка ре- 
жима Миймога ОМА2 (1— есть}, 1 — поддержка режима Ми \мога 
ОМА 1 (1 — есть), 0 — поддержка режима МиН\мога ОМА 0 (1 — есть) 


Состав: 15—8 — резерв, 7—0 — поддержка режимов РО 


Минимальное время передачи для режима Ми!\мога ОМА в наносекун- 
дах 


Рекомендуемое производителем время передачи для режима Ми мога 
ОМА в наносекундах 


Минимальное время передачи для режима Р!О в наносекундах 
Минимальное время передачи для режима Р!О с ОВБУ в наносекундах 
Необязательные и зарезервированные поля 


Главный (та/ог) номер версии интерфейса: 15—8 — резерв, 7 — под- 
держка версии АТА/АТАР!-7 (1— есть}, 6— поддержка версии 
АТА/АТАР1-6 (1 — есть), 5 — поддержка версии АТА/АТАР!-5 (1 — есть}, 
4 — поддержка версии АТА/АТАР!-4 (1 — есть), 3 — поддержка версии 
АТА/АТАР!-3 (1 — есть}, 2—1 устарели, 0 — резерв 


Дополнительный (тог) номер версии интерфейса 


Поддержка команд: 15 устарел, 14 — команда мор (1 — есть), 13— 
команда ВЕАР ВОЕЕЕК (1 — есть), 12 — команда ивттЕ вогЕЕв (1 — есть}, 
11 устарел, 10 — защищенная область хоста (1 — есть), 9 — команда 
РЕУТСЕ ВЕЗЕТ (1 — есть}, 8 — прерывание ЗЕРМСЕ (1 — есть}, 7 — пре- 
рывание при освобождении шины (1 — есть), 6 — упреждение (1 — есть}, 
5 — кэширование записи (1 — есть}, 4 — поддержка пакетных команд 
(0 — есть}, 3 — управление питанием (1 — есть), 2 — поддержка команд 
для сменных носителей (1 — есть}, 1 — поддержка команд секретности 
(1 — есть), О — поддержка команд Зтай (1 — есть) 


Зарезервированы 


Установка набора команд или свойств: 15 устарел, 14 — команда мор 
(1 — включить}, 13 — ВЕАР ВОЕЕЕВ (1 — включить}, 12 — ИВТТЕ ВОЕРЕВ 
(1 — включить}, 11 устарел, 10 — защищенная область хоста (1 — вклю- 
чить), 9 — РЕУТСЕ ВЕЗЕТ (1 — включить}, 8 — прерывание ЗЕВМСЕ (1 — 
включить), 7 — освобождение шины (1 — включить}, 6 — упреждение (1 — 
включить), 5 — кэширование записи (1 — включить), 4 — упреждение 
(1 — включить}, 3 — управление питанием (1 — включить}, 2 — работа со 
сменными носителями (1 — включить}, 1 — набор команд секретности 
(1 — включить}, 0 — набор команд ЗМАВТ (1 — включить} 


Зарезервированы 
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Таблица 11.69 (окончание) 


Смещение 
слова 


Описание 


88 Режимы ОМА: 15 — резерв, 14 — выбор Инга ОМА 6 (1 — выбран}, 13 — 
выбор ЦНга ОМА 5 (1 — выбран}, 12 — выбор ЦНга ОМА 4 (1 — выбран), 
11 — выбор Ува ОМА 3 (1 — выбран}, 10 — выбор ЦНга ОМА 2 (1 — вы- 
бран}, 9 — выбор ЦНга ОМА 1 (1 — выбран), 8 — выбор ЦУйга ОМА 0 (1 — 
выбран), 7 — резерв, 6 — поддержка ЦНга ОМА 6 (1— есть}, 5 — под- 
держка Цйга ОМА 5 (1 — есть}, 4 — поддержка ЦЙга ОМА 4 (1 — есть}, 3 — 
поддержка Уйга ОМА 3 (1 — есть), 2 — поддержка Уйга ОМА 2 (1 — есть}, 
1 — поддержка Уйга ОМА 1 (1 — есть), 0 — поддержка Ува ОМА 0 (1 — 
есть}, 


89—255 — Зарезервированы 


11.2.4.7. Команда /ОЁЕЕ 


Команда позволяет задавать промежуток времени для перевода устройства в 
режим простоя (14е). Команда является обязательной для устройств АТА. 
Формат команды показан в табл. 11.70. 


Таблица 11.70. Формат команды тртЕ 


Биты 
Регистры 
С О О ЗО ОЕ ПО ПОСОИ ИС 
1х1 Не используется 
128 Значение времени простоя ({техамше) 
1х3В Не используется 
1х4в Не используется 
1556 Не используется 
1х76 ЕЗЬ 


В регистре 1х2ь задается промежуток времени. Возможные значения пока- 
заны в табл. 11.71. 


Для инициализации команды в регистр 1х2. следует записать код времени, 
В 1х6н — номер устройства ОЕ\У (0 или 1), а затем в регистр 1х7 записать 
код команды ЕЗь. При успешном выполнении регистры будут содержать 
следующую информацию: 
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1. Регистр 1х6ъ будет хранить номер выбранного устройства. 


2. Регистр 1х7ь будет иметь вид: ВЗУ = 0, РВРУ = 1, РЕ= 0, РКО =0и 
ЕВК = 0. 


В случае ошибки регистры будут иметь следующий вид: 


1. В регистре 1х1ь бит АВВТ будет установлен в 1, если устройство не под- 
держивает команду или произошло аварийное завершение. 


2. Регистр 1х6н будет хранить номер устройства (бит 4). 


3. Регистр 1х7н будет иметь вид: ВЗУ = 0, РКРУ = 1, РЕ =1 (при сбое 
устройства), ОКО =би ЕВК = 1. 


Таблица 11.71. Значения времени для команды тртЕ 


Код времени Значение времени 


о0й Время простоя не используется 
011—ЕОВ ({темаше * 5) сек 
Е1|-ЕВВ (({теуаме - 240) * 30) мин 

ЕСВ 21 мин 

ЕРЬ от 8 до 12 часов 

КЕВ Резерв 

КЕВ 21 мин 15 сек 


11.2.4.8. Команда ГОЕЕ 1ММЕГБ/АТЕ 


Эта команда позволяет немедленно перевести устройство в режим простоя. 
Команда является обязательной для устройств АТА. Формат команды пока- 
зан в табл. 11.72. 


Таблица 11.72. Формат команды ТРТЕ ТММЕРТАТЕ 






Регистры 








Не используется 








1х2 Не используется 
1х3 Не используется 
1х4в Не используется 


Не используется 


Е1В 
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Для инициализации команды в регистр 1х6н следует записать номер устрой- 
ства РЕ\ (0 или 1), а затем в регистр 1х7ь записать код команды Е1ь. При 
успешном выполнении регистры будут содержать следующую информацию: 


1. Регистр 1х6 будет хранить номер выбранного устройства. 


2. Регистр 1х7н будет иметь вид: ВЗУ =9, РВРУ = 1, РЕ= 0, ОВО =0би 
ЕКК = 0. 


В случае ошибки регистры будут иметь следующий вид: 


|. В регистре 1х1н бит АВКТ будет установлен в 1, если устройство не под- 
держивает команду или произошло аварийное завершение. 


2. Регистр 1хб6в будет хранить номер устройства (бит 4). 


3. Регистр 1х7ь будет иметь вид: ВЗУ = 0, РКРУ = 1, РЕ =1 (при сбое 
устройства), РКО =биЕБВК = 1. 


Рассмотрим пример для перевода жесткого диска в режим простоя (лис- 
тинг 11.38). 


Листинг 11.38. Перевод жесткого диска в дежурный режим 
са1] ТзВеааАТА; ждем, пока порт освободится 


поу ОХ, Её ; порт ТЕбВ 
поу АБ, ОАО ; первое устройство на первом канале 


оц ОХ, АБ ; записываем значение в порт 
тс ОХ ; порт 1Е7Ь 

поу АБ, ОЕ1А ; код команды ТОЬЕ ТММЕОТАТЕ 
оц ОХ, АБ ; записываем значение в порт 


Аналогичный пример для С++ показан в листинге 11.39. 


// функция для перевода устройства в режим простоя 

у%о1а Зеета1е () 

{ 
ТзВеаЧуАТА (); // ждем, пока порт освободится 
оцЕРоге ( 0х1Р6, ОхАО, 1); // первое устройство на первом канале 
ОЦЕРОГЕ ( 0х1Е7, 0хЕ5, 1); // код команды СНЕСК РОМЕВ МОБЕ 


В рассматриваемых примерах не обрабатываются ошибки, чтобы макси- 
мально упростить принципы использования управляющих команд. 
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11.2.4.9. Команда МОР 


Команда позволяет прервать все невыполненные команды, размещенные в 
очереди, и установить бит аварийного завершения АВКТ. Команда является 
обязательной для устройств АТАР1. Формат команды показан в табл. 11.73. 


Таблица 11.73. Формат команды МОР 





Биты 
Регистры 
аа [о 
1х15 Дополнительный код 
1х28 Не используется 
1х3в Не используется 
1х4аъ Не используется 
155. Не используется 
1х 66 ОЕ\У | Резерв | Резерв | Резерв | Резерв 
1х7Ь оон 


Для инициализации команды в регистр 1х1н следует записать дополнитель- 
ный код (табл. 11.74), в 1х6ь — номер устройства РЕМ (0 или 1), а затем в 
регистр 1х7 записать код команды оон. 


Таблица 11.74. Дополнительный код для команды МОР 


Дополнительный 


Описание 

код 

о0ь (мор) Прерывает выполнение очереди команды и возвращает 
аварийное завершение (АВНТ) 

01ь (МОР Аафо Ро11) Не прерывает выполнение команд и возвращает аварийное 
завершение (АВНТ) 

021-22 (резерв) Не прерывает выполнение команд и возвращает аварийное 


завершение (АВНТ) 


Данная команда всегда возвращает ошибку. В регистре 1х1ъ бит АВКТ уста- 
навливается в |, а регистр 1х7ь имеет вид: В$У = 0, РКУ = 1, РЕ = | (при 
сбое устройства), ОВО = би }ЕВК = 1. 


11.2.4.10. Команда РАСКЕТ 


Данная команда позволяет подготовить устройство для последующей пере- 
дачи пакетной команды. Команда используется только для устройств АТАР1. 
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Важно помнить, что данную команду всегда нужно вызывать перед приме- 
нением любой пакетной команды из набора $С51. Формат команды показан 
в табл. 11.75. 


Таблица 11.75. Формат команды РАСКЕТ 


Биты 


Регистры 
в [в] 44| зато 


118 Не используется | ом ОМА 


1х28 Очередь команд Не используется 
у 


1х3й Не используется 

1х4 Количество байтов передачи (0—7) 
1х56 Количество байтов передачи (8—15) 
175 А0В 


В регистре 1х1в следует установить режим передачи в бите ОМА (1 — ОМА, 
0— РО) и возможность перекрытия команл в бите ОУТ, (1 — использо- 
вать). Если применяется очередь команд, в регистр 1х2в (7—3) следует запи- 
сать значение тэга для команды (от 0 до 31), иначе этот регистр не исполь- 
зуется. В регистры 1х4в и 1х5в следует поместить младший и старший 
байты для размера блока данных, используемых последующей пакетной 
командой. К слову, если пакетная команда из набора 5С5[ не содержит до- 
полнительных параметров и данных, регистры 1х4в и 1х5в не используются. 


При успешном выполнении регистры будут содержать следующую инфор- 

мацию: 

1. Регистр 1х2н будет иметь вид: 0 — установлен в 1, { — установлен в 1, 
2—0, 7—3 — значение от 0 до 31 при поддержке очереди команд. 

2. Регистр 1х6ъ будет хранить номер выбранного устройства. 


3. Регистр 1х7н будет иметь вид: ВЗУ =0, РВБУ = 1, ОМЕО =Е (для 
ОМА), ЗЕВУ = | (при использовании очереди команд), ОКО =0 и 
СНК = 0. 

В случае ошибки регистры будут иметь следующий вид: 

1. Регистр 1х7: бит ПЛ зависит от команды, бит ЕОМ зависит от команды, 
бит АВКТ = 1, поле Зепзе Кеу (7—4) будет содержать код ошибки соглас- 
но спецификации 5С51. 

2. Регистр 1х2ь: С/Б =1, ИО = 1, ВЕЁ = 0, поле очереди команд (7—3), 
значение от 0 до 31. 
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3. Регистр 1х6н будет хранить номер устройства (бит 4). 
4. Регистр 1х7н: В$ЗУ =0, ОКОУ=1, ОЕ=1Т (ри сбое устройства), 
ЗЕКУ = 1 (если есть перекрытие), РКО = би СНК = 1. 


Например, чтобы подготовить дисковод к приему простой ЗСЗ[-команды, 
не имеющей параметров, можно сделать так, как показано в листинге 11.40. 





: Листинг 11.40. Подготовка дисковода к работе с пакетными командами 


са11 Т5зВеааАТА; ждем, пока порт освободится 
шоу ОХ, 171 $; порт 1718 


пюу АБ, 0 ; использовать режим РТО 

опЕ ОХ, АБ ; записываем значение в порт 
11с 0Х ; порт 1726 

поу АБ, 0 ; не используем 

опЕ ОХ, АБ ; записываем значение в порт 
1пс ОХ ; порт 1735 пропускаем 

12с ОХ ; порт 1746 

поу АБ, 0 ; данных для передачи не будет 
опё ОХ, АБ ; записываем значение в порт 
1пс ОХ ; порт 1758 

поу АБ, 0 ; данных для передачи не будет 
оц ОХ, АБ ; Записываем значение в порт 
11с 0х ; порт 1768 

шоу АГ, ОВОр ; первое устройство на втором канале 
очё ОХ, АБ ; записываем значение в порт 
1пс ОХ ; порт 1776 

поу АБ, ОАОН ; код команды РАСКЕТ 

оп ОХ, АБ ; записываем значение в порт 


Аналогичный пример для С++ показан в листинге 11.41. 


Листинг 11.41. Подготовка дисковода к работе с пакетными командами в С++ 





// функция для подготовки устройства к приему пакетной команды 
у01А ЗеЕРаскее () 
{ 

ТзВеаЧуАТА (); // ждем, пока порт освободится 


ОЧЕРОгГЕ ( 0х171, 0х00, 1); // использовать режим РТО 

ОЦЕРоге ( 0х172, 0х00, 1); // не используем 

оцЕРоге ( 0х174, 0х00, 1); // данных для передачи не будет 
очЕРоге ( 0х175, 0х00, 1); // данных для передачи не будет 
ОЦЕРОГЕ ( 0х176, ОхвО, 1); // первое устройство на втором канале 
ОпЕРоге ( 0х177, 0хАО, 1); // код команды РАСКЕТ 


Глава 11. Дисковая подсистема 433 


11.2.4.11. Команда РЕАО ОМА 


Эта команда позволяет считывать данные с использованием канала ОМА. 
Команда является обязательной для устройств АТА. Формат команды пока- 
зан в табл. 11.76. 


Таблица 11.76. Формат команды ВЕАР РОМА 


Биты 
Регистры 
в [за [о 
1х1 Не используется 
1х28 Число секторов 
1хЗВ Адрес 1 ВА (0—7) 
1хав Адрес (ВА (8—15) 
1х5В Адрес 1 ВА (16—24) 
оз [т [ревю т [оу | моживАенкей 
1х78 с8ь 


В регистр 1х2н следует записать количество секторов (от 1 до 256), которые 
будут переданы. Если установить этот регистр в 00ъ, будет использовано 
значение в 256 секторов. В регистры 1хЗь, 1х4в и 1х5в записывается на- 
чальный адрес сектора, с которого начнется передача данных. В регистр 
1х5н записывается номер выбранного устройства на канале (бит 4) и стар- 
щие 4 разряда адреса сектора (биты 0—3). В регистр 1х7н записывается код 
команды с8Ъ. 


При успешном выполнении регистры будут содержать следующую инфор- 
мацию: 


1. Регистр 1х6н будет хранить номер выбранного устройства. 


2. Регистр 1х7ь будет иметь вид: ВЗУ = 0, РКРУ = 1, БЕ =0, РВО =0би 
ЕВК = 0. 


11.2.4.12. Команда ВРЕАБ МОИЕТИРЕЕ 


Эта команда предназначена для считывания с диска определенного количе- 
ства секторов. Команда является обязательной для устройств АТА. Формат 
команды показан в табл. 11.77. 


В регистр 1х2н следует записать количество секторов (от 1 до 256), которые 
будут переданы. Если установить этот регистр в 00п, будет использовано 
значение 256 секторов. В регистры 1хзн, 1х4н и 1х5ь записывается началь- 
ный адрес сектора, с которого начнется передача данных. В регистр 1х5% 
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записываются номер выбранного устройства на канале (бит 4) и старшие 
4 разряда адреса сектора (биты 3—0). В регистр 1х7ь записывается код 
команды сАв. 


Таблица 11.77. Формат команды ВЕАР МОГТТРТЕ 


Биты 
Регистры 
в [аа [о 
1х18 Не используется 
1х2в Число секторов 
1х3В Адрес 1 ВА (0-7) 
1х4в Адрес 1 ВА (8-15) 
1х5В Адрес 1 ВА (16—24) 
Ба [1 [рез [1 [ое | мазей 
1х78 с4в 


При успешном выполнении регистры будут содержать следующую инфор- 
мацию: 


1. Регистр 1х6ь будет хранить номер выбранного устройства. 


2. Регистр 1х7н будет иметь вид: ВЗУ = 0, РКРУ = 1, ОЕ = 0, РКО =0би 
ЕКК = 0. 


11.2.4.13. Команда ВЕАО $ЕСТОВН ($) 


Команда позволяет прочитать с диска указанное количество секторов и 
является обязательной для устройств АТА. Формат команды показан в 
табл. 11.78. 


Таблица 11.78. Формат команды вВЕАР $ЗЕСТОВ ($) 


Биты 
Регистры 
А ПС ОЗ М ОЕ О ОЕ ОО С 
1х18 Не используется 
1х2в. Число секторов 
1х3Зв Адрес (ВА (0—7) 
1х4В Адрес (ВА (8—15) 
1х5В Адрес ЕВА (16—24) 


ые ое ЕЕ 


1х7 208 
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В регистр 1х2в.следует записать количество секторов (от | до 256), которые 
будут переданы. Если установить этот регистр в 00ь, будет использовано 
значение в 256 секторов. В регистры 1х3в, 1х4н и 1х5. записывается на- 
чальный адрес сектора, с которого начнется передача данных. В регистр 
1х55 записывается номер выбранного устройства на канале (бит 4) и стар- 
шие 4 разряда адреса сектора (биты 3—0). В регистр 1х7в записывается код 
команды 201. 


При успешном выполнении регистры будут содержать следующую инфор- 
мацию: 


1. Регистр 1хбв будет хранить номер выбранного устройства. 


2. Регистр 1х7ь будет иметь вид: ВЗУ = 0, ОВБУ = 1, РЕ = 0, ОКО = би 
ЕВК = 0. 


В случае ошибки команда завершит выполнение. При этом состояние реги- 
стров будет таким: 


1. Регистр 1х1ь: бит ММ (1) будет установлен в 1 при отсутствии сменного 
носителя, бит АВЕТ (2) будет установлен в 1; бит МСК (3) будет уста- 
новлен в | при наличии сигнала для смены носителя; бит ОМЕ (4) будет 
установлен в |, если указанный адрес не найден; бит МС (5) будет уста- 
новлен в | при попытке смены носителя во время выполнения команды; 
бит ОМС (6) будет установлен в 1 при некорректных данных. 


2. Регистры 1хзь, 1х4 и 1х5ь будут содержать адрес сектора, при чтении 
которого произошла ошибка. 


3. Регистр 1х6н будет хранить номер устройства (бит 4) и младшие разряды 
адреса сектора. 

4. Регистр 1х7в: ЕКК =1, ОКО =0, РЕ=Т (при сбое устройства), 
ОЕРУ = [и ВУ = 0. 


Рассмотрим пример кода для чтения сектора жесткого диска (листинг 11.42). 


; выделяем буфер для одного сектора 512 байт 
Зафа_зесбог ЧБ 512 дир (?} 

; код программы 

са11 ТзВеааАТА; ждем, пока порт освободится 
шоу ОХ, 1Е2Ь ; порт 1Е26 





пох АТ, 1 ; читаем один сектор 

оп ОХ, АБ ; записываем значение в порт 
Лас ОХ ; порт 1ЕЗЬ 

поу АБ, 1 ; сектор 1 

оп ОХ, АБ ; записываем значение в, порт 
11с ОХ ; порт ТРАВ 

оу АБ, 0 ; цилиндр 0 
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ое ОХ, АБ ; записываем значение в порт 


12ас ОХ .; порт 1Е5В 

шоу АБ, 0 ; старший байт цилиндра равен 0 
опЕ ОХ, АБ ; Записываем значение в порт 
1пс ОХ ; порт 1Е6бЬ 


поу Аь, ОАОН ; первое устройство на первом канале и режим СН$ 
оаЕ ОХ, АБ ; записываем значение в порт 

11с ОХ ; порт 1Е7Ь 

поу АГ, 200 ; команда ВЕАБ ЗЕСТОВ 

оц ОХ, АБ ; записываем значение в порт 

са11 ТзВеадАТА; ‘ждем, пока порт освободится 

шоу ОХ, ТЕОВ ; порт 1Е0В для данных 

оу СХ, 256 ; количество читаемых слов ( 512 / 2) 

шоу РТ, ОЕЕзеф дафа_зесфког ; указываем адрес буфера 

гер 1пзм ; читаем все данные 


Аналогичный пример на С++ будет выглядеть так, как показано в листин- 
ге 11.43. 


: Листинг 11.43. Чтение сектора жесткого диска в С++ 





// пишем функцию для чтения одного сектора 
у014 ВеааЗеског () 
{ 
// буфер для данных 
МОВО мрафа [256]; 
ТзВеаЧуАТА (); // ждем, пока порт освободится 
ооЕРогЕ ( 0х1Е2, 0х01, 1); // читаем один сектор 
ооЕРогЕ ( 0х1#РЗ, 0х01, 1); // номер сектора 
опЕРогЕ ( 0х1Е4, 0х00, 1); // цилиндр 0 
оиЕРогЕ 0х1Е5, 0х00, 1); // старший байт цилиндра равен 0 
очЕРоге 0х1Е6, 0хАО, 1); // первое устройство на первом канале 
// и режим СН$ 
оЧЕРОГЕ 0>1Е7, 0х20, 1); // код команды РАСКЕТ 
ТэВеаДУуАТА (); // ждем, пока порт освободится 
// чимтаем данные в буфер 
Бог (1 =0; 1 < 256; 1++) 


{ 





1пРог® ( 0х1Е0, ( РОМОВО) &( мБафба[1]), 2}; 


Функцию можно сделать универсальной, добавив аргументы для номера 
сектора, числа секторов и указателя на буфер данных. При этом, естествен- 
но, следует изменить код внутри самой функции. 
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11.2.4.14. Команда РЕАО УЕР!РУ ЗЕСТОВ ($) 


Данная команда позволяет читать данные с диска с проверкой, но, в отли- 
чии от предыдущей команды, не передает их на компьютер. Команда явля- 
ется обязательной для устройств АТА. Формат команды показан в табл. 11.79. 


Таблица 11.79. Формат команды ВЕАР УЕВТРУ ЗЕСТОК ($) 


Биты 
1518 Не используется 
1х28 Число секторов 
1х3ЗВ Адрес 1 ВА (0—7) 
1х4в Адрес 1 ВА (8—15) 
1х5В Адрес (ВА (16—24) 
1 ж6В Адрес | ВА (24—27) 
1х7В 40в 


В регистр 1х2в следует записать количество секторов (от 1 до 256), которые 
будут переданы. Если установить этот регистр в 00в, будет использовано 
значение в 256 секторов. В регистры 1х3в, 1х4в И 1х5в записывается на- 
чальный адрес сектора, с которого начнется передача данных. В регистр 
1х5н записывается номер выбранного устройства на канале (бит 4) и стар- 
шие 4 разряда адреса сектора (биты 3—0). В регистр 1х7ь записывается код 
команды 405. 


При успешном выполнении регистры будут содержать следующую инфор- 
мацию: 


1. Регистр 1х6 будет хранить номер выбранного устройства. 


2. Регистр 1х7н будет иметь вид: ВЗУ = 0, ОКБУ = 1, РЕ =0, РКО =0дби 
ЕВК = 0. 


В случае ошибки команда завершит выполнение. При этом состояние реги- 
стров будет таким: 


1. Регистр 1х1н: бит ММ (Г) будет установлен в 1 при отсутствии сменного 
носителя; бит АВЕТ (2) будет установлен в 1; бит МСК (3) будет уста- 
новлен в 1 при наличии сигнала для смены носителя; бит ОМЕ (4) будет 
установлен в 1, если указанный адрес не найден; бит МС (5) будет уста- 
новлен в | при попытке смены носителя во время выполнения команды; 
бит ОМС (6) будет установлен в | при некорректных данных. 
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2. Регистры 1х3в, 1х4н и 1х5в будут содержать адрес сектора, при чтении 
которого произошла ошибка. 


3. Регистр 1х6 будет хранить номер устройства (бит 4) и младшие разряды 
адреса сектора. 


4. Регистр 1х7: ЕКВ =1, ОКО =0, ОЕ=| (при сбое устройства), 
ОКОУ = Ти В$У = 0. 


11.2.4.15. Команда 5ЁЕЕР 


Команда позволяет перевести устройство в режим "сна" и является обяза- 
тельной для устройств АТА. Формат команды показан в табл. 11.80. 


Таблица 11.80. Формат команды 5тЕЕР 





Биты 
Регистры 
ев азарт [о 

118 Не используется 

1х21 Не используется 

1х3в Не используется 

1хав Не используется 

1х5 Не используется 

1х68 |1 | Резерв | 1 | ОЕУ | Не используется 

1х76 ЕбЬ 


При успешном выполнении регистры будут содержать следующую инфор- 
мацию: 


1. Регистр 1х6ь будет хранить номер выбранного устройства. 


2. Регистр 1х7 будет иметь вид: ВЗУ = 0, ОВОУ = 1, ОЕ =0, ОКО =0и 
ЕВК = 0. 


В случае ошибки регистры будут иметь следующий вид: 


1. В регистре 1х1ь бит АВКТ будет установлен в 1, если устройство не под- 
держивает команду или произошло аварийное завершение. 


2. Регистр 1х6ъ будет хранить номер устройства (бит 4). 


3. Регистр 1х7в будет иметь вид: ВЗ\У = 0, ОКРУ = 1, РЕ =1 (при сбое 
устройства), ОКО = би ЕВК = 1. 


11.2.4.16. Команда И/Р/ТЕ $ЕСТОН ($) 


Эта команда позволяет записать указанное количество секторов на диск. 
Команда является обязательной для устройств АТА. Формат команды пока- 
зан в табл. 11.81. 
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Таблица 11.81. Формат команды ИРТТЕ ЗЕСТОЕ (5) 


Биты 
Регистры 
в [ваза 
1518 Не используется 
1=2в Число секторов 
1=3В Адрес ЕВА (0—7) 
1кав Адрес ЕВА (8—15) 
1558 Адрес ВА (16—24) 
в корте 
1х7В зов 


В регистр 1х2. следует записать количество секторов (от 1 до 256), которые 
будут переданы. Если установить этот регистр в оон, будет использовано 
значение в 256 секторов. В регистры 1х3в, 1хАв И 1х55 записывается на- 
чальный адрес сектора, с которого начнется передача данных. В регистр 
1х5. записывается номер выбранного устройства на канале (бит 4) и стар- 
шие 4 разряда адреса сектора (биты 3—0). В регистр 1х7в записывается код 
команды зов. 


При успешном выполнении регистры будут содержать следующую инфор- 
мацию: 


1. Регистр 1х6 будет хранить номер выбранного устройства. 


2. Регистр 1х7 будет иметь вид: ВЗУ = 0, РЕРУ = 1, РЕ =0, ОКО =0ди 
ЕКВ = 0. 


В случае ошибки команда завершит выполнение. При этом состояние реги- 
стров будет таким: 


1. Регистр 1х1ь: бит ММ (1) будет установлен в 1 при отсутствии сменного 
носителя: бит АВВТ (2) будет установлен в 1; бит МСК (3) будет уста- 
новлен в [ при наличии сигнала для смены носителя; бит ТОМЕ (4) будет 
установлен в 1, если указанный адрес не найден; бит МС (5) будет уста- 
новлен в | при попытке смены носителя во время выполнения команды; 
бит ОМС (6) будет установлен в | при некорректных данных. 


2. Регистры 1х3, 1хан и 1х5 будут содержать адрес сектора, при чтении 
которого произошла ошибка. 


3. Регистр 1х5н будет хранить номер устройства (бит 4} и младшие разряды 
адреса сектора. 

4. Регистр 1х7р: ЕВВК =1, ОКО =0, РЕ=|1 (при сбое устройства), 
ОКРУ = Ти В$У = 0. 
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Перед тем как приводить пример работы с этой командой, хочу предупре- 
дить читателей о серьезной опасности выполнения кода записи на диск. 
Пример приводится исключительно в демонстрационных целях и его ни в 
коем случае не следует повторять. Игнорирование этого замечания может 
привести к потере информации или выходу из строя жесткого диска! Рас- 
смотрим пример кода для записи сектора жесткого диска (листинг 11.44). 


; выделяем буфер для одного сектора 512 байт 
Яафа_зесфог а 512 ар (0) 

; код программы 

са11 ТзВеаЧАТА; ждем, пока порт освободится 
шоу ОХ, 1Е2В ; порт 1Е2В 


поУу АБ, 1 ; записываем один сектор 

оп ПХ, АБ ; записываем значение в порт 
З0с ОХ ; порт 1ЕЗЬ 

поу АБ, 1 ; сектор 1 

оц ПХ, АБ ; записываем значение в порт 
11с ОХ ; порт 1Е4В 

поу АЦ, 0 ; цилиндр 0 

оц ПХ, АБ ; записываем значение в порт 
1пс 0Х ; порт 1Е5В 

поу АБ, 0 ; старший байт цилиндра равен 0 
оп ПХ, АБ ; записываем значение в порт 
1п1с ОХ ; порт ТЕ6бЬ 


поу АБ, ОАОВ ; первое устройство на первом канале и режим СН$ 
оп ПХ, АБ ; записываем значение в порт 

11с ОХ ; порт 1ЕТЬ 

поу АГ, ЗОН ; команда МВТТЕ ЗЕСТОВ 

ое ОХ, АБ ; записываем значение в порт 

са11 Т5ВеаЧАТА; ждем, пока порт освободится 

поу Ох, 1ЕО0Б ; порт 1ЕОВ для данных 

пох СХ, 256 ; количество читаемых слов ( 512 / 2) 

поу 5Т, ОЕЁзеЕ Яафа_зес®ог ; указываем адрес буфера 

тер опё5м ; записываем все данные 


Аналогичный пример на С++ представлен в листинге 11.45. 


// пишем функцию для записи одного сектора 
у01а Иг1ебесфох ({) 
{ 

// буфер для данных 

МОВР мПРафа [256]; 
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петзее ( &мБафа, ОхГЕ, 256); 
ТзВеаЧУАТА (); // ждем, пока порт освободится 
ОЧЕРОгЕ ( 0х1Е2, 0х01, 1); // записываем один сектор 


ОЧЕРоге ( 0х1ЕЗ, 0х01, 1); // номер сектора 

ОПЕРОогЕ ( 0х1Е4, 0х00, 1); // цилиндр 0 

оиЕРохгЕ ( 0х1Е5, 0х00, 1); // старший байт цилиндра равен 0 
ОЧЕРоге ( 0х1Еб, ОхАО, 1); // первое устройство на первом канале 


// и режим СН5 
оцЕРогЕ ( Ох1Е7, 0х30, 1); // код команды МВТТЕ ЗЕСТОК 
Т5ВеаЧУАТА (); // ждем, пока порт освободится 
// пишем данные в порт 
Фох (111 =0; 1 < 256; 1++) 
{ 
оцЕРохге ( 0х1Е0О, мрафа[1], 2); 


На этом можно завершить тему программирования портов ввода-вывода. 
Многое осталось не сказанным, но полученные здесь сведения помогут вам 
без проблем разобраться со всем остальным. Я же хотел бы познакомить вас 
с некоторыми способами программирования дисковой подсистемы чёрез 
интерфейс \/т32 АР. 


11.3. Использование \Ит32 АР| 


Для работы с дисковой подсистемой используется универсальная функция 
Реу1сеТоСопехо1. Она является каналом между программой и драйвером уст- 
ройства. Мы разберем несколько способов ее использования. Для начала 
попробуем применить эту функцию для открывания лотка СО-КОМ (или 
аналогичного устройства со сменными носителями). Исходный код для вы- 
полнения данной задачи представлен в листинге 11.46. 


: Листинг 11.46. Использование функции реу1 сетоСопего1 
: для открывания лотка 


#$1осЁаде "5ЕЧаЕх.В" 
Ч1осфааде <М1110с&1.1> 
$1пстаЧе <Мазузфем. [> 
// значение флага и константы 
}$Чеё1пе УМТМ32_ ОТОС 20$ _ТОСТЬ 1 
`фАеЕ1те СЕ ЕЪАС 0х0001 
// определяем структуру для хранения значений регистров 
фуреаеЕ зЕхис& ОТОС ВЕСТЗТЕК$ 
{ 
ОМОКР хеа_ЕВХ; 
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Р\ОВО 
РМОВО 
ОМОВО 
РМОКО 
РМОВО 
ОМОВО 
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тед ЕБХ; 

хед_ЕСХ; 

‘теч ЕАХ; 

теч_ЕОТ; 

тед_ЕЗТ; 

теч ЕТЪад$; 

} ОТОС _ВЕСТЗТЕВ$, *РОТОС_ВЕСТЗТЕВ$; 

// функция для открытия лотка 

у01А Е)есё 98МЕ ( БОреп); // открывает и закрывает лотки 


// для всех устройств 


// объявляем переменные модуля 
ОТОС ВЕСТЗТЕВ$ Вед; 

// реализуем функцию Е}ес®е 
у01а Е)есе 98МЕ ( БОреп) 


{ 


НАМОЬЕ Ю)еу1се = М1; 
©оо1 ЮВеза1Е = Еа15е; 
РИОВР @мВези1+ = 0; 


ОМОВО @мОг1уез 
11 пРо$ = 


0; 
0, 1СН = 0; 


ип$1апеЯ 10 ибг1уеТуре = 0; 
ТСНАВ з21ебсфег[8]; 
2егоМетогу ( &ВКед, з12еоЕЁ ( Веа)); 
// определяем число установленных устройств 
Фирт1уе$ = Сеёфо91са1Ох1уе$ (); 
1Е( БОреп) // открыть лоток 


{ 


\в11е 


{ 


1Е 
{ 


{ 


( амОг1уез$) 


ФмОт1уе & 1) // если есть диск 


1СН = 0х41 + пРоз; 

зЕгсру ( з21еффехг, ( соп5® сВаг*) &1СН); 
зЕгсае ( з2Тебфехг, ";:\\"); 

// определяем тип устройства 

ирту1уеТуре = СеёОг1луеТуре ( э21ефег); 
// если устройство со сменным носителем 
1Е ( одт1уеТуре == ОВТУЕ_СРВОМ) 


{ 


// открываем драйвер устройства 
ВРеу1се = Сгеа®еЕ11е ( "\\\\.\\уи1п32", 0, 0, МОЩЬ, 0, 
ЕИЕ ЕЪАС РЕБЕТЕ_ОМ СЪОЗЕ, МОМ); 
1Е ( ВОеу1се != ТМУАЬТО НАМОГЕ УАГОЕ) 
// не удалось открыть драйвер 


Глава 11. Дисковая подсистема 


} 


} 


// заполняем поля структуры 
Вед.геа ЕАХ = 0х4400; // номер функции 
Вед.гедч_ЕВХ = пРоз + 1; // номер устройства 


Вед.хед ЕСХ = МАКЕМОВО ( 0х49, 0х08); // код подфункции 
Вед.гед_Е1адз = 0х0001; // устанавливаем флаг переноса 


// вызываем функцию Беу1сеТоСопего1 
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ЬВез11& = Беу1сеТоСопёго ( НОеу1се, УМТМЗ2_ОТОС_р20$_ТОСТЬ, 


&Вед, з17еоЕ ( Вед), &Вед, 


$12е0Е ( Вед), & ЧиВеза\, 0); 


// проверяем результат операции и флаг СЕ 
1Е ( !ЮВезыа1 || { Вед.гед_Е1адз & СЕ _ЕЬАС)) 
{ 

// закрываем драйвер устройства 

С1озеНапЯ1е ( ЮБеу1се); 

Юреу1се = МОЦ; 


} 
// закрываем драйвер устройства 
С1озеНапЯ1е ( ЮОеу1се); 
Ьбеу1се = МОЦ; 
} 
} 


Чмох1уез$ >>= 1; 
пРо$ ++; 


5 


Сгсру ( з21ебфег, ""); 


е1зе // закрыть лотки 


{ 


\В11е ( ЭмОг1уез) 


{ 


1Е 
{ 


( Чм0х1уез & 1) 


1СН = 0%41 + пРоз; 

5Ехсру ( з2Ъеббег, ( сопз® сВаг*) &1СН); 
5&гса® ( з7Теффех, ":\\"); 

// определяем тип устройства 

иОх1уеТуре = Сефрх1уеТуре ( з2Теефег); 


1Е ( иргфуеТуре == РВТУЕ_СОВОМ) // если устройство со сменным 


// носителем 


// выполняем функцию МСТ для закрытия лотка 
пс15епа56х1п9 ( "беф СРАца1о Роог С1озеЯ Ма1*"), МИЦ, 
МО, МО); 
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Чмрх1уез >>= 1; 

ПРо$ ++; 

зЕгсру ( з2Ъебфег, ""); 
} 


Не забудьте добавить в опции компоновщика ссылку на библиотеку 
УМитт.НЬ. Рассмотренная выше функция рассчитана на работу в Уп- 
ом 95/98/МЕ. Для использования ее в \Утдо\$ МТ/2000/ХР/$ВЗ придется 
немного изменить код, согласно листингу 11.47. 


Пистинг 11.47. Использование функции Реу1сетоСопего1 
: в МИпаомз МТ/2000/ХР/$ВЗ 


#$10с1оаае "з6ааёх.В" 
$1ос1аае <М1п10с&1.6> 
// функция для открытия лотка 
уо1А Е)есе МТ ( ЮОреп}; // открывает и закрывает лотки 
// для всех устройств 
// реализуем функцию Е)ес® 
у01а Е)десе МТ ( БОреп} 
{ 
НАМОЬЕ ВОеу1се = М0; 
ОМОВР ЧмСоае = 0, 9мрОг1уез = 0, 9мВезо1 = 0; 
ТСНАВ э2Теффег[8]; 
ТСНАВ $з2О0еу1сеМмаме [15]; 
106 пРоз = 0, 1СН = 0; 
ип$19пеЯя 110 оОг1уеТуре = 0; 
1Е( ЮОреп) // открыть лоток 
Чисоде = ТОСТЬ 5ТОВАСЕ ЕЗЕСТ_МЕРТА; 
е15е // закрыть лоток 
@иСо@е = ТОСТЬ ЗТОВАСЕ ТОАБ МЕРТА; 
// определяем число установленных устройств 
Чмохлуез = бе1091са10г1уез (); 
\р11е ( ЭдмОг1уез) 
{ 
1Е ( дОт1уез & 1) // если есть диск 
{ 
1СН = 0х41 + пРоз; 
зЕгсру ( з2.еффег, ( сопзЕ сваг*) & 1СН); 
зЕгсае ( з7Ъеббег, ":"); 
// определяем тип устройства 
арх1уеТуре = СеЕрх1уеТуре ( з71есег); 
1Е ( обг1уеТуре == ОВТУЕ _СОВОМ} // если устройство со сменными 
// носителями 
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// получаем имя для устройства 
зЕгсру ( 370еу1семаще, "\\\\.\\"); 
5&гса*( з70еу1семате, з7еффех); 
// открываем устройство 
ВРеу1се = СгеакеЁ11е ( $20еу1сеМате, СЕМЕВТС_ВЕАР, 
ЕТЕ ЗНАВЕ_ВЕАР | ЕТЬЕ ЗНАВЕ ИВТТЕ, МОБ, 
ОРЕМ ЕХТЗТТМС, 0, №); 
1Е ( БФеу1се != ТМУАЬТОЬ НАМОЬЕ УАБОЕ) // если устройство открыто 
{ 
// вызываем функцию Беу1сеТоСопехо1 
Реу1сеТоСопёго1 ( НОеу1се, ЯмСоае, МОШ., 0, МО, 
О, &9мКезо1, МИШ)); 
// закрываем устройство 
С1озеНапа1е ( РГеу1се); 
зЕхсру ( $2О0еу1сеМмапте, 


"") ; 


// переходим к следующему 
@иОх1уе$ >>= 1; 

пРо$ ++; 

$Егсру ( з7Ъебфег, ""); 


Представленные вашему вниманию тексты кодов достаточно упрощены для 
понимания. Теперь поговорим о возможности блокировать лоток устройст- 
ва, поддерживающего такую возможность. Для выполнения задачи нам по- 
требуется все та же функция реу1сетоСопеко1. Чтобы блокировать лоток в 
операционных системах УЛп4о\з 95/98/МЕ, следует написать код, показан- 
ный в листинге 11.48. | 





Листинг 11.48. Блокировка лотка в \\Ип4о\мз 95/98/МЕ 


Н1рс1а9е "5Е4аЁх.В" 

41ос1Таае <И1п1осет.в> 

// значение флага и константы 
#ЧеЕ1те \МТМ32_ ОТОС 20$ _ТОСТЬ 1 
4+ЧеЕ1пе СЕ ЕЦАС 0х0001 

// определяем структуры 

#ргадта расКк (1) 

СуредеЕ з&гасЕ _РАВАМВГОСК 


{ 


ВУТЕ ЮОрега®1оп; 
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ВУТЕ ЮМоптоскК$; 
} РАВАМВГОСК, *РРАВАМВГОСК; 
#ргадта раск () 
фуредеЕ з&гисё _РТОС_ВЕСТЗТЕВ$ 
{ 
ОМОВР гед ЕВХ; 
ОМОВКР гед_ЕОХ; 
ОМОВР гед_ЕСХ; 
РМОВР гед_ВАХ; 
РИОВО гед_ЕОТ; 
РМОКР гед_ЕЗТ; 
РМОВР гед Е1а9$; 
} ОТОС ВЕСТЗТЕВ$, *РОТОС ВЕСТЗТЕВ$; 
// функция для блокировки лотка 
у01А Ъоск 98МЕ ( Боск); 
// объявляем переменные модуля 
ОТОС ВЕСТЗТЕВ$ Вед; 
РАВАМВГОСК 1оскТгау; 
// реализуем функцию Боск _98МЕ 
уо1А Шоск 98МЕ ( Боск} 
{ 
НАМОЬЕ ЮОеу1се = МОБ; 
Роо1 ЬБези1+ = Еа1зе; 
РИОВО 9мВе$01& 0; 
ОИОВР @9мОг1уез 0; 
171е пРо$ = 0, 1СН = 0; 
1$19пеЯ 11 оОбх1уеТуре = 0, оЕ1ача = 0; 
ТСНАВ $з71ебфехг[8]; 
2егоМетогу ( &Вед, з1теоЕ ( Веа)); 
// определяем режим блокировки 
1Е ( БГосКк) // блокировать лоток 


И 


и 


оЕ1аа = 0; 
е1зе // разблокировать лоток 
оЕ1аа = 1; 


// определяем число установленных устройств 
Ямрх1уез = бееод1са10к1уез ()}; 
1Е( ЮОреп) // открыть лоток 
{ 
%11е ( ЧмОгктуез) 
{ 
1Е ( Чмрог1уе & 1) // если есть диск 
{ 
1СН = 0х41 + пРо$; 
зёгсру ( з2Ъеёфехг, ( соп5® сваг*) &1СН); 
зексаф ( з7тЪеффег, ":\\"); 
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// определяем тип устройства 
арх1уеТуре = бебрОхг1уеТуре ( 52Теефег); 

// если устройство со сменным носителем 

1Е ( ирг1уеТуре == РВТУЕ_СОВОМ) 

{ 

// открываем драйвер устройства 

НОеу1се = СгеафеЕ11е ( "\\\\.\\ум1п32", 0, 0, МО, 0, 

ЕТТЕ ЕТАС РЕБЕТЕ_ОМ СЪОЗЕ, МО); 
1Е ( ВОеу1се != ТМУАЬТЬ НАМРЬЕ УАГОЕ,) 
// не удалось открыть драйвер 


// заполняем поля структуры 

1оскТхау.РОрега1оп = аЕ1ад; 

Вед.хед ЕАХ = 0х4400; // номер функции 

Вед. хгед_ЕВХ = пРоз + 1; // номер устройства 

Вед.гед ЕСХ = МАКЕМОВО ( 0х48, 0х08); // код подфункции 
Вед.гед ЕБХ ({ ОМОВО) &1осКТгау; // указатель на структуру 
Вед.гед ЕТадз = 0х0001; // устанавливаем флаг переноса 


| 


// вызываем функцию Беу1сеТоСоп&то1 
ЬВезо1 = Беу1сетоСоп®го1 ( ВОеу1се, УМТМЗ2_РТоС_р0$_ТОоСТЦ, 
&Вед, 31теоЕ ( Вед), &Вед, 
$12е0Е ( Вед), & ЧмВези1е, 0); 
// проверяем результат операции и флаг СЕ 
1Е ( 'ЮВезо1е || ( Вед.геч_ЕТадз & СЕ _ЕЪАС)) 
{ 
// закрываем драйвер устройства 
С1озеНапа1е ({ ЮО)еу1се); 
ВРеу1се = МИЦ; 


} 
// закрываем драйвер устройства 
С1озеНап91е ( №О)еу1се); 
$1еер ( 50); // небольшая задержка 
НОеу1се = №1; 
} 
} 

Чмох1уез >>= 1; 

пРоз$ ++; 

5Ехсру ( з2Ъеффег, ""); 


Чтобы создать аналогичную функцию для \ш4о\мз МТ/2000/ХР/$ВЗ, следу- 
ет написать код, показанный в листинге 11.49. 
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: Листинг 11.49. Блокировка лотка в \Мтао\мз М№Т/2000/ХР/$ВЗ 
#1пс1аае "зедаЁх.В" 
#1пс1оае <\М1п10с%1.[> 
// функция для открытия лотка 
у014 Госк МТ ( Бфоск); // открывает и закрывает лотки 
// для всех устройств 

// реализуем функцию ТосКк МТ 
У01А Боск МР ( Боск) 
( 

НАМОГЕ РБеу1се = МОТ; 

ОИОВР амОу1уез О, ЧмВезо1Е = 0; 

ТСНАВ з2ееег[8]; 

ТСНАВ 320еу1сеМмапе [15]; 

11 пРоз = 0, 1СН = 0; 

и051апеа 1пЕ аБх1уетуре = 0; 

РВЕУЕМТ МЕРТА ВЕМОУАТ 1осКТгау; 

?егоМепогу ( &1осКТгау, з12еоЕ ( РВЕУЕМТГ МЕОТА ВЕМОУАТ))}; 

1Е( Боск) // блокировать лоток 

ТосКТгау. Ртеуеп(МеЧ1аКетоуа1 = %гие; 
е1зе // разблокировать лоток 
1осКТгау.РгеуепЕМеЯ1аКетоуа1 = Еа1зе; 


и 


// определяем число установленных устройств 
ФОт1уез = Сеео91са1ЮРг1уез (); 
\р11е ( амОглуез) 
{ 
1Е ( ЧмОт1уез & 1) // если есть диск 
{ 
1СН = 0х41 + пРоз; 
зЕгсру ( з2Теббег, ( сопзЕ сраг*) & 1СН); 
зЕгсае ( з2Ъебеег, ":"); 
// определяем тип устройства 
ибу1уеТтуре = беерг1луеТуре ( з2Ъеббег); 
1Е ( аОг1уеТуре == ОВТУЕ_ СОВОМ) // если устройство со сменными 
// носителями 


// получаем имя для устройства 

зЕгсру ( 520еу1семане, "\\\\.\\"); 

з&гса®е( з20еу1семаме, э2Ъебеег); 

// открываем устройство 

РБеу1се = Сгеа®еЕ11е ( 520еу1сеМмаще, СЕМЕВТС ВЕАБ, 
ЕТТЕ ЗНАВЕ ВЕАР | ЕТЬЕ ЗНАВЕ МВТТЕ, МО, 
ОРЕМ ЕХТУТТМС, 0, МОБ); 

1Е ( ПОеу1се != ТМУАЬТО НАМОГЕ УАТОЕ) // если устройство открыто 

{ 
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// вызываем функцию Пеу1сетоСопего1 
Реу1сеТоСопего1 ( РОеу1се, ТОСТЬ ЗТОВАСЕ МЕОТА_ВЕМОУАЪ, 


(ГРУОТР) &1осКТкау, 
312е0Е ( РВЕМЕМТ_МЕРТА_ВЕМОУАЬ), МОМ, 0, 
&ЧиВези1е, №11); 
// закрываем устройство 
С1озеНапа1е ( ПРеу1се); 
зЕгсру ( з2Беу1семапе, 


"") ; 


} 
// переходим к следующему 


амотлуез >>= 1; 
пРо5 ++; 
зЕгсру ( з2Ъебкек, 


"") ; 


На этом я завершаю тему программирования дисковых устройств в УЛидо\5, 
а читателям советую самостоятельно изучить файл УМшюсИ.И на предмет 
других возможностей управления устройствами СО-КОМ. 


ГЛАВА 12 


Пространство шины РС! 


Почему, спросите вы, автор называет шину РСТ (РенрНега! Соплропепе 
[пегсоппес®) пространством. Конечно, в целом шина осталась щиной и вы- 
полняет те же функции, что и всегда. Однако современная шина РСЕ пред- 
ставляет собой не просто общие каналы передачи данных для различных 
устройств, но и выполняет глобальную управляющую функцию. Она имеет 
собственное адресное пространство, что позволяет получать доступ ко всем 
устройствам в системе, независимо от интерфейса. Но самым важным пре- 
имуществом шины является возможность гарантированного получения всех 
доступных портов ввода-вывода и номеров прерываний для последующей 
работы с устройствами. Не секрет, что немногие системные модули имеют 
жестко прописанные адреса портов и номера прерываний. 


Как узнать, где расположено то или иное устройство?. На своем компьютере 
можно конечно зайти в настройки оборудования и посмотреть, а на чужом 
придется придумывать что-нибудь другое. Например, попросить пользовате- 
ля вашей программы ввести нужные данные. Согласитесь, этот способ хо- 
рош только для опытных пользователей, не говоря уже о коммерческой не- 
состоятельности такого "интерактивного" проекта. Вот для того, чтобы ре- 
шить эти и другие проблемы, следует пользоваться возможностями шины 
РС!. Только в этом случае вам удастся написать приложение, не зависящее 
от конфигурации оборудования. Исходя из всего сказанного, я хотел бы 
прелложить вам познакомиться с двумя основными способами программи- 
рования шины РСТ: 


1. С помощью функций РС ВЮ$З. 
2. Напрямую через порты ввода-вывода. 


12.1. Общие сведения 


Современная шина РСЕ объединяет практически все устройства в компью- 
тере: аудио и видео (АСР и РС), сетевые и $С$1, южные и северные мос- 
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ты. Через мосты осуществляется связь с процессором, памятью, кэщем, 
дисковой подсистемой, мышью и клавиатурой. Шина РС] не просто связы- 
вает перечисленные устройства, но также предоставляет удобный интерфейс 
для доступа и управления ими. Для управления используются так называе- 
мые циклы шины с частотой 33 и 66 МГц. Данные частоты являются об- 
щими для всех устройств на шине и позволяют синхронизировать работу. 
Чтобы упорядочить функционирование разнообразного оборудования, шина 
РС] назначает каждому свой номер. По этому номеру впоследствии опреде- 
ляется тот или иной тип устройства. Кроме того, шина РС предоставляет 
общее конфигурационное пространство, которое можно использовать из 
своей программы для перечисления подключенных устройств и получения 
различной информации о них (адреса ввода-вывода, идентификационные 
номера, номера прерываний). Конфигурационное пространство представляет 
собой шаблон размером 256 байт. Первые 16 байт являются неизменными 
для любых типов устройств. Остальные могут иметь специфические значе- 
ния, зависящие от самого устройства. В эти байты записывается различная 
опознавательная информация, по которой пользователь может определить 
категорию устройства. Формат пространства шины РСТ приведен в табл. 12.1. 


Таблица 12.1. Конфигурационное пространство шины РС! 


Биты 


Смещение 
[эм [ 2 158 7 


оон Оемсе 0 \Уепаог Ю 
04в З4а\и$ Соттапа 
о8в Саз$ Со4де Вемзюп 0 


осв ВТ Неадег Туре Т аепсу Титег | СасВе Цпе Зе 





10ь 
14в 
18ь 
Вазе АЧагез$ Нед егз 
1Сь 
208 
24в 
28 В СагаБиз С!$ Ройщег 
2Сь Зирзузет \Мепдог 10 
Зов Ехрапзюп РВОМ Вазе Ад@гез$ 
34в Резерв 
38Ь Резерв 


405—ЕЕВ Определяются производителем устройства 
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Поскольку программист может получить доступ к пространству шины РС в 
режиме чтения и записи, необходимо всегда придерживаться одного прави- 
ла: для изменения параметров (в том числе отдельных битов) нужно сначала 
прочитать значение параметра, а затем, изменив желаемые биты, записать 
их обратно. В обязательном порядке производителями должны поддержи- 
ваться следующие поля: Ое\у!се ШО, Уепдог ТО, За, Соттапд, С1а5$ Соде, 
Кемчоп Ш и Неааег Туре. Остальные поля необязательны. 


Приведем описание табл. 12.1. 


О Уепдог ГГ определяет уникальный идентификатор производителя устрой- 
ства. Только для чтения. Идентификаторы для наиболее известных в 
России устройств представлены в табл. 12.2. 


Таблица 12.2. Идентификаторы производителей устройств (Уепаог 10) 


\Уепаог 0 Производитель 
0Е11В Сотраа 
10008 Зутьюоз Гос (Ед) 
10025 АТ! ТесБпоюде$ 
10056 А4уапсе овес (АОЁ) тс 
10085 Ерзоп 
100АВ Рпоепх Тесппоючез 
10086 Мавопа! Зетикопдисюог 
1013в Ситиз Гос 
10145 1ВМ 
1016. РИЙзи 1СЕ Регзопа! Зузетз 
10195 ЕЩедгоир Сотрщег Зу$ 
101Св Мезет Овна! 
10205 НКасН! Сотрщег Еес{гопс$ 
10228 Адуапсеа Мсго Оемсез$ (АМО) 
1023в Тидет Мегозуетз 
1024в Репйй Оаа Зузетз 
1025. Асег пс 
1028Ь Ое! Сотрщег Согр 
1029ь Зетеп$ Мхаой АС 


102Вь Матох СгарНс$ пс 
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\Уепаог 
102ЕВ 
102ЕВ 
1033в 
10378 


10398 
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Таблица 12.2 (продолжение) 


Производитель 

Ойуе# Адуапсе4 Тесбпоюду 
ТозНфа Атенса 

МЕС Еесготс$ Нопд Копб 
Ннас ! Мсго Зует$ тс 
Зйсоп !щедгаед Зузетз ($13) 
Зеко Ерзоп Согр 
Немле{-Раскаг4 Сотрапу 
Азизек Сотрщег тс 
АЧарес 

ОРТИпс 

ЕЁЗА СтЬН 

Теха$ |пэгитеги$ (Т|) 

Зопу Согр 

ННась М4 

Моюгоа 

Рготке Тесвпоюду 

Аса{е! СТ 

Мази: Еестопс$ 
Нуипда! Еесготс$ Атепса 
Баемоо Теесот МА 
УАМАНА Согр 

Срамесв Сотрщег Со Ца 
Супх Согр 

ЕС Еесгопс$ 

Даа Тесрпоюду Согр (ОТС) 
Зип Мюгозу${етз 
Оатопа Мите а Зузет$ 
Затзипд Нес!гопс$ Со МА 
Ча Тесппоюдез$ МА 


Оцатит Согр 
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\Уепдог О 
10АЭН 
1087ь 
10в9в 
10С4в 
10САВ 
10РЕВ 
10Е1В 
1102. 
11068 
1131в 
11526 
117АВ 
11808 
11АОВ 
11 ВОВ 
11СЕЬ 
12408 
12508 
126АВ 
1274в 
127АВ 
12В9Н 
12025 
1414В 
142ЕВ 
14585 
1563В 
4843В 
53338 


80868 


Таблица 12.2 (продолжение) 


Производитель 

Эйсоп СгарЫс$ 

ЗСОМ Согр, Мемюогкта Ом5юп 
Асег [абз псогрогае4 (АН) 
А\мгаг4 ЗоН\маге Мегпафопа! пс 
Рийзи Мегоеесгопс 

МмА!а Согр 

Текгат Тесппоюду Согр ЦА 
Стеа#уе Ёаб$ 

\ЛА Тесвпоюдез$ {пс 

РЫйр$ Зеткопаисюг$ 
МАХТОВ Согр 

А-Тгепа Тесбпоюду 

Асов Со Ма 

Е№е-Оп Соттипксайоп$ пс 
Ртпасе Зуз{етз пс 

Рюпеег Еестопю Согр 
Магаоп Тесппоюде$ Согр 
Е$$ Тесвпоюду 

ЕехтагК {1егпайопа! пс 
Еп$оп а 

Аоскме! Зетсопаисюг Зуз{етз 
ЗСОМ Согр, Модет Омзюп 
ЭТВ/ИМм4а/$С$ Твотрзоп 
Мсго5ой 

\Уцес Мите а 

Сюа-Вуе Тесппоюду 

А-Ттеп4 Тесбпоюду Со МА 
Негсшез Сотрщег Тесбпоюду пс 
$3 пс 


|(е! Согрогайоп 


456 


\Уепаог Р 
90041-90058 
АОАОБ 


Е000В 
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Таблица 12.2 (окончание) 
Производитель 
АЧарес 


Аореп пс 


МИпропа 


С Ое\мсе 12 — идентификатор определенного устройства. Только для чте- 
ния. Идентификаторы для наиболее известных в России устройств пред- 
ставлены в табл. 12.3. 


Оемсе ОР 
00р1ь 
70205 
4747Ь 
5043Ь 

50481—5058Ь 
5144В 
51591 
5245. 
60056 
00025 
00478 
70046 
7007ь 
7404в 
7411. 
5240. 
051ЕВ 
0520. 


05258 


Таблица 12.3. Идентификаторы популярных устройств 


Название устройства 

1740 РС 

У$В Сотгойег 

Ваде ЗО Рю 

Ваде 128 Рто АСР 4х 

Ваде 128 

Вадеоп ВОВА 

Аадеоп УЕ 

Ваде 128 СЕ РС! 

Сгуза! С$4281 РС! Ау4ю 

РС! ю МСА Внаде (ВМ) 

РСИцо РС! Впаде (ВМ) 

АМО-751 СРУ ю РС! Впаде (АМО) 
АМО-751 РС! о АСР Впаде (АМО) 
АМО-755 УЗВ Ореп Ноз{ Сотго!ег (АМО) 
АМО-766 ЕОЕ Сотгойег (АМО) 

ЕОЕ Сотгойег (Асег) 

МСА-1164$С Музйдие 220 АСР (Манох) 
МСА-С2008В СЫрзе! (Ма!гох) 

МСА-С400 СЫрзет (Ма!гох) 
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Бемсе 2 
10008 
15258 
60575 
15218 
15318 
00185 
00195 
00208 
00286 
002Вы 
00208 
002ЕЪ 
ОбАОБ 
01008 
01016 
01028 
01108 
01126 
01508 
01518 
0152. 
02005 
00028 
70025 
03058 
06805 
11068 
00015 
00025 


0003в 


Таблица 12.3 (продолжение) 


Название устройства 


МСА-С100 СЫрзе{ РС! (Машох) 
Ризюп 6450 АСР (Мацох} 
Мио\МОЕО 0С10/0СЗ0 (Мио) 

АН М1521 Ааадат Ш! СРУ ю РС! Видде (Асег) 
АН М1531 Аадат 1МЛ\+ СРУ ю РС! Впаде (Асег) 
Ама 128 

Ама 1282Х 

Ама ТМТ 

АМА ТМТ2 

Ама ТМТ2 

АМА ТМТ2 Моде! 64 

\Уатма 

АМА ТМТ2 Аваат 

СеРогсе 256 

СеРогсе 256 ООВ 

СеГогсе 256 Цйга 

СеРогсе2 МХ 

СеРогсе2 МХ ЦНга 

СеРогсе2 СТ$ 

СеРогсе? СТ$ ООН 

СеЕГогсе2 ЦНга 

СеРогсеЗ 

ЕМУИЛОК1 Ацаю СЫрзе! (Сгеа#уе) 
РС! Сатероц уоузйск (Сгеайме) 
\Т8363 КТ133 Зузет Сопнойег (А) 
\Т82С680 Арою Рб (\ЛА) 

\т82С0570 МУ ТОЕ Сопиоег (МА) 
ЗОх Уоо4оо 

ЗОБ Уоодоо2 

З06х Уоо4доо ВапзВее 
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Бемсе Ш 
00055 
58805 
8813Н 
8814в 
8900н 
8А1 ОН 
8А20В 
8А22В 
8А2 бп 
9102. 
01225 
12226 
12395 
2412. 
24168 
24188 
24218 
2422. 
24418 
244АВ 
70108 
70205 
71118 
7112. 


71138 
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Таблица 12.3 (окончание) 


Название устройства 
ЗОБ Моо4оо3 

5880 Аи4юРС! 

$3 Тноб4 

$3 Тюб4Ц\+ 

$3 Тно64\/2/0Х 

$3 МВСЕ/СХ2 

$33 Зауаде3з 0 

33 бауаде4 


| $3 РгоЗамаде 


$33 бамаде 2000 

82437ЕХ 430ЕХ (че!]) 

82092АА ЕЕ Согигойег (пе!) 

82371ЕВ 430ЕХ РС! ЕЕ Соггойег (ме!) 

82801АА 8хх СЫрзе! ЗВ Соттойегз (ме!) 
82801АА 8хх СНрзе! АС'97 РС! Модет (1\е|) 
82801АА 8хх Сырзе! Ни6 №ю РС! Впаде (те!) 
82801АВ 8хх СЫрзе! ОЕ Согигойег (ще!) 

82801 АВ 8хх СЫрзе! ИЗВ Сопигойег (ще!) 

82801ВА Виз Мазег ОЕ Сопго!ег (ме!) 
82801ВАМ (КН2) ЧиаМА/00 ОЕ Сопгойег (те) 
823715В РНХЗ ЕЕ Согиго!ег (те!) 

8237138 РИХЗ ЗВ Сопоег (пе!) 

82371 АВ/ЕВ/МВ РИХ4 ЕОЕ Сопго!ег (1%е!) 

82371 АВ/ЕВ/МВ РИХ4 УЗВ Согигойег (ще!) 

82371 АВ/ЕВ/МВ РИХ4 Ромег Мападетеги Сотто!ег (те!) 





С СотитапЯ открывает доступ к командному регистру, который позволяет 
осуществлять грубую регулировку циклов шины РСЕ. Для чтения и запи- 
си. Формат регистра показан в табл. 12.4. Следует помнить, что не каж- 
дое устройство поддерживает данное поле. 
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Биты 


8 
9 
10—15 


Таблица 12.4. Формат командного регистра (Соттапд) 


Описание 


Управление возможностью устройства принимать и посылать данные 
в пространстве РС! (1 — включить, 0 — выключить) 


Управление возможностью устройства работать с памятью 
(1 — включить, 0 — выключить) 


Управление возможностью устройства работать в качестве ведущего 
на шине РС! (1 — включить, 0 — выключить) 


Поддержка устройством специальных циклов шины 
(1 — включить контроль, 0 — игнорировать} 


Управление сигналом для записи в память (1 — включить, 
0 — выключить) 


Управление доступом к регистрам палитры для УСА-совместимых 
и других графических устройств (1 — разрешить доступ к палитре, 
0 — запретить доступ к палитре) 


Поддержка устройством ошибок четности (1 — включить, 
0 — выключить) 


Резерв 
Резерв 
Возможность транзакций для устройства (1 — включить, 0 — выключить) 


Резерв 


П За является необязательным полем. Позволяет получить информацию 
о состоянии шины РСЕ. Для чтения и записи. Формат регистра показан 


в табл. 12.5. 
Таблица 12.5. Формат регистра состояния (З1аз) 
Биты Описание 
0—4 — Резерв 
5 Только для чтения. Указывает на поддержку устройством частоты шины 
66 МГц (1 — поддерживает 66 МГц, 0 — только 33 МГц) 
6 Только для чтения. Указывает на поддержку устройством пользова- 
тельских настроек конфигурации (1 — да, 0 -- нет) 
7 Только для чтения. Указывает на поддержку устройством транзакций 
(1 — да, 0 — нет) 
8 Резерв 
9—10 — Определяют типы синхронизации для устройства 
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Таблица 12.5 (окончание) 


Биты Описание 


11 Бит устанавливается в 1 при аварийном завершении транзакции для 
целевого устройства 

12 Бит устанавливается в 1 ведущим устройством при аварийном завер- 
шении транзакции 

13 Бит устанавливается в 1 ведущим устройством при аварийном завер- 
шении транзакции 

14 Резерв 

15 Бит устанавливается в 1 при обнаружении устройством ошибок четности 


О Ве\мбюп ТО определяет номер версии устройства в дополнении к Ое\мсе 
ГО. Только для чтения. 


0 С!а$$ Соёе определяет класс устройства. Только для чтения. Формат это- 
го поля представлен в табл. 12.6. Код базового класса и подкласса позво- 
ляют идентифицировать тип устройства. Возможные значения кодов для 
базового класса показаны в табл. 12.7. Значения кодов подкласса и ин- 
терфейса перечислены в табл. 12.8. Формат байта интерфейса для кон- 
троллеров ШЕ представлен в табл. 12.9. 


Таблица 12.6.- Формат поля С!а5$ Соде 


Код базового класса Код подкласса 


Таблица 12.7. Коды базового класса 









Смещение 






Описание Интерфейс 


Код базового 


класса Описание 
о0в Устройство появилось до введения кодов класса 
01В Контроллер устройства хранения большой емкости 
028 Сетевой контроллер 
ов Контроллер дисплея 
04в Мультимедийное устройство 
05В Контроллер памяти 
о6в Устройство моста 


07В Обычный контроллер связи 
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Код базового 
класса 


08 
09в 
ОАВ 
ОВВ 
осв 
ООЬ-—ЕЕВ 
РЕВ 


Таблица 12.7 (окончание) 


Описание 


Системная периферия 

Устройство ввода 

Стыковочный узел 

Процессор 

Контроллер последовательной шины 
Резерв 


Устройство не подходит ни под один класс 


Таблица 12.8. Коды подкласса и интерфейса 


Базовый - 
класс Подкласс | Интерфейс | Описание 
00в 


008 00в Все выпущенные ранее устройства, 
кроме УСА-совместимых 

01ь 00в \УСА-совместимые устройства 

оон 0 





02в 








Контроллер $С5$1 

Контроллер ОЕ 

Контроллер флоппи-дисковода 
Контроллер 1Р! 

Контроллер ВАЮ 

208 Контроллер АТА с одиночным ОМА 
Контроллер АТА с цепочкой ОМА 
Контроллер ЗАТА 

Контроллер ЗАТА с интерфейсом АНС1 1.0 
Контроллер ЗА$ 

Контроллер для другого устройства хранения 
Контроллер Еете! 

Контроллер Токеп Ата 

Контроллер РОГ! 

Контроллер АТМ 


Сетевой контроллер другого типа 
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Базовый 
класс 


оз 
04 
05. 
О6Н 


078 
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Подкласс Описание 


\УСА-совместимый контроллер 


Таблица 12.8 (продолжение) 


8514—совместимый контроллер 
Контроллер ХСА 
Контроллер ЗО 


Контроллер дисплея другого типа 


оон 00ь 
011 
018 ов 
021 005 
вов оон 
оо оон Устройство для работы с видео 
011 00в Устройство для работы с аудио 
808 00й Другое мультимедийное устройство 
о0в оон 
018 оон 
вов Обь 
оон оон 


Контроллер оперативной памяти 
Контроллер флэш-памяти 


Другой тип контроллера памяти 





Мост хоста 

01ь 005 Мост |ЗА 

02. 008 Мост Е!5А 

03в 00ь Мост МСА 

04в о0в Мост РС-ю-РС1 

058 008 Мост РСМСА 
Мост МиВиз 
Мост СагаВиз 


Другой тип моста 


Контроллер последовательного порта 
(ХТ-совместимый) 


018 16450-совместимый контроллер последователь- 
ного порта 

021 16450-совместимый контроллер последователь- 
ного порта 

015 005 Контроллер параллельного порта 

015 Контроллер двунаправленного параллельного 
порта 

025 Контроллер параллельного порта ЕСР 1.Х 


80й 00п Контроллер другого устройства связи 
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Базовый 
класс 


св 


Таблица 12.8 (окончание) 


Контроллер прерываний 8259 
01 Контроллер прерываний |1ЗА 
02ь Контроллер прерываний ЕЗА 


01ь 00в Контроллер ОМА 8237 
01в Контроллер ОМА |1$А 
026 Контроллер ОМА Е!ЗА 





02В 00 Контроллер системного таймера 8254 
018 Контроллер системного таймера 1ЗА 
02н Контроллер системного таймера Е1ЗА 

ов оон Контроллер часов реального времени 


Контроллер часов реального времени 1ЗА 


Контроллер клавиатуры 
018 00% Контроллер дигитайзера 
02ь 00й Контроллер мыши 
80ъ 008 Другой тип контроллера ввода 


00в 00й Контроллер стыковочного узла 
80ъ ов Другой тип контроллера 
о0ъ 00в 386 

486 

Репйит 


АрКа 
РомегРС 








Сопроцессор 
Контроллер 1ЕЕЕ 1394 
АССЕЗ$ 

З$А 

и$В 

РЬЫге СВаппе! 
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Таблица 12.9. Формат байта интерфейса для контроллеров ОЕ 






Описание 


Приведем краткий комментарий к табл. 12.9. 


» Бит 0 определяет режим работы для первого канала контроллера. Если 
бит установлен в 1, канал работает в режиме РСТ, иначе — в режиме 
совместимости. 


» Бит 1 указывает на поддержку первичным каналом фиксированного 
режима выполнения операций (0 — режим установлен, {1 — поддер- 
живаются оба режима). 


» Бит 2 определяет режим работы для вторичного канала контроллера. 
Если бит установлен в 1, канал работает в режиме РСТ, иначе — в ре- 
жиме совместимости. 


» Бит 3 указывает поддержку вторичным каналом фиксированного ре- 
жима выполнения операций (0 — режим установлен, | — поддержи- 
ваются оба режима). 


» Биты 4—6 зарезервированы и должны быть установлены в 0. 
» Бит 7 определяет поддержку выбора ведущего устройства на канале. 


С Сасве [пе 517е является необязательным. Данное поле доступно, если 
устройство поддерживает запись в память. Для чтения и записи. 


О Емепсу Т!тег является необязательным. Определяет время ожидания для 
ведущего устройства на шине РСТ. Для чтения и записи. 


С Неадег Туре определяет информацию со смещения 108. Бит 7 указывает 
на многофункциональное устройство (1). Биты 0—6 идентифицируют 
формат дальнейшей информации (005 — формат согласно данной табли- 
це, 01ь — формат определяется спецификацией моста РС1-ю-РСУ. Толь- 
ко для чтения. 


С ВЗТ является необязательным полем. Управляет режимом самотестиро- 
вания для устройства. Если устройство не поддерживает самодиагности- 
ку, значение поля будет равно 0. Бит 7 указывает на поддержку режима 
самотестирования (1 — есть). Запись в бит 6 единицы позволит выпол- 
нить самотестирование указанного устройства. Биты 0—3 определяют ре- 
зультат операции (0 — ошибка). Для чтения и записи. 


О Вазе Ад@гез$ Кер5ет$ содержит все доступные адреса ввода-вывода для 
работы с устройством. Для чтения и записи. 
С Сагаби$ С1$ Роицщег используется для специфических устройств связи. 


Подробнее можно узнать из спецификации устройств РСМСЛА. Только 
для чтения. 
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О Пиеторе Ште позволяет получить номер выделенной для устройства ли- 
нии прерывания. Для чтения и записи. 


С Мш_ОСим и Мах_ТГа определяют время ожидания и параметры его на- 
стройки. Время ожидания измеряется в микросекундах. Только для чте- 
НИЯ. 


Остальные поля в табл. 12.1 необязательны и могут отличаться для различ- 
ных устройств. 


12.2. Использование функций РС! ВЮ$ 


Функции РСТ ВТОЗ предназначены для работы во всех режимах Х86: защи- 
щенном и реальном, 16-ти и 32-разрядном. Для 16-разрядных программ 
доступ к функциям возможен через прерывание 11 1Аь (физический адрес 
ОООЕЕЕбЕВ). Доступ в 32-разрядных программах осуществляется через вызов 
точки входа в защищенный режим. Разработчики рекомендуют выделять 
для стека не менее 1024 байт. 


Перед началом работы всегда следует убедиться в наличии РСТ ВТО$. В ре- 
альном режиме для этого применяется специальная функция, в защшищен- 
ном режиме следует использовать физический адрес. Данные о РСТ В1О$ 
размером 16 байт могут находиться в диапазоне адресов 0Е0000—ОЕЕЕЕЕН. 
Формат данных показан в табл. 12.10. 


Таблица 12.10. Формат структуры РС! ВЮ$ 


Смещение Размер 


поля поля Описание 
00в 4 байта Сигнатура в виде АЗС!И-символов "_32_" 
04в 4 байта 32-разрядный физический адрес точки входа 
08в 1 байт Младший номер версии (00н, о1ь или о2н) 
09ь 1 байт Размер структуры (16 байт) 
бАВ 1 байт Контрольная сумма (сумма всех полей должна 
равняться 0) 
овь 5 байтов Зарезервированы и должны быть установлены в 0 


Следует просканировать диапазон адресов. 0Е0000-5—ОЕЕЕЕЕЬ, пока не будет 
‚ найдена сигнатура РСТ ВТОЗ (”_32_”). 


А теперь рассмотрим функции РСТ В10%$. 
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12.2.1. Функция В101В 


Эта функция позволяет определить наличие в системе поддержки РСТ В10$. 


Использование: 
1. В регистр Ан следует поместить код функции вл1ь. 


2. В регистр ль следует поместить код подфункции 01. 
3. Вызвать прерывание 11 1АВ. 


Выход: 


После выполнения функции в регистр Ан будет помещен код состояния 
(00в, если РСГ В[ГО$ имеется). В регистр Ерх будет помещена сигнатура 
"РСТ" (в рь 'Р', в рн 'С’, далее 'Ги в старший байт пробел). В регистр лт, бу- 
дет записан код аппаратного механизма. Имеются два таких механизма: 
первый (015) и второй (02). В вн будет сохранено значение старшего номе- 
ра версии, а в въ — младшего номера. Например, для версии 2.10 в вн будет 
записано значение о2ь, а в вь — 104. В регистр ст, будет помещен номер по- 
следней шины в системе. Кроме того, в случае ошибки флаг се будет уста- 
новлен, иначе сброшен. Рассмотрим пример для проверки наличия РС] 
В1О$ в системе (листинг 12.1). 





пох АН, ОВ1В ; код функции В1П 

поу АБ, ОШ ; код подфункции 01 

116 1АВ ; вызываем прерывание 

спр АН, ООН ; состояние выполнения функции 

ле № РСТ ; поддержка РСТ ВТО$ в системе отсутствует 
спр ЕПХ, 20494350.; проверяем сигнатуру "РСТ " с пробелом 
пе № РСТ ; что уродно, только не РСТ ВТОЗ 

; определяем количество шин и сохраняем на всякий случай 
пох рубе рег МОМ ВО$, СЬ 


12.2.2. Функция В102В 


Функция позволяет найти определенное устройство на шине. Для этого 
следует знать Уепдог ГО и Оем:се ШО желаемого устройства. 


Использование: 
1. В регистр Ан следует поместить код функции вл1ь. 
2. В регистр Ат, следует поместить код подфункции 028. 


3. В регистр сх записывается идентификатор устройства (Ремсе 1). Диа- 
пазон значений лежит от 00001 До ЕЕЕЕВ. 
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4. В регистр ох записывается идентификатор производителя (Уеп4дог [). 
Диапазон значений лежит от 00008 До ЕЕЕЕБ. 


5. В регистр 5т нужно записать номер индекса. Если вы хотите найти более 
одного устройства, следует установить индекс в соответствующее значе- 
ние. Начальное значение равно 0. 


6. Вызвать прерывание 1пе 1Аь. 


Выход: 


Носле выполнения функции в регистр Ан будет помещен код результата 
(табл. 12.11). В регистр вн будет записан номер шины (от 0 до 255). В вь бу- 
дет помещен номер устройства (биты 3—7) и номер функции (0—2). В слу- 
чае ошибки флаг се будет установлен, иначе сброшен. 


Таблица 12.11. Возвращаемые значения функций РС! ВО$ 


Код 


значения Описание 
ов Операция успешно завершена 
81а Указанная функция не поддерживается 
83В Недопустимый идентификатор производителя (\Мепадог !О0) 
86п Устройство не найдено 
878 Недопустимый номер регистра 
88п Ошибка выполнения 
898 Недостаточный размер буфера 


Рассмотрим пример поиска видеоадаптера СеРогсе3, представленный в лис- 
тинге 12.2. 


по АН, ОВ1Н ; код функции ВВ 

пох АГ, 021 ; код подфункции 026 
поу СХ, 02005; Беу1се ТР для СеГогсеЗ 
поу ОХ, 100ЕБ; Уепаог ТР для М№у1а1а 


оу 5Т, 0 ; индекс 0 
10Е 1АБ ; вызываем прерывание 
сшр АН, 861 ; проверяем результат операции 


пе №0 ЕТМР ; устройство не найдено 
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12.2.3. Функция В10ЗВ 


Функция позволяет найти устройства указанного класса. Можно использо- 
вать данную функцию, если вы не знаете точных идентификаторов устрой- 
ства и производителя. 

Использование: 

1. В регистр ан следует поместить код функции в1ь. 


2. В регистр Ат, следует поместить код подфункции озь. 
3. В регистр Есх следует записать значение кода класса (в младшие три байта). 
4 


В регистр зт нужно записать номер индекса. Если вы хотите найти более 
одного устройства, следует установить индекс в соответствующее значе- 
ние. Начальное значение равно 0. 


5. Вызвать прерывание {пе 12ь. 


Выход: 

После выполнения функции в регистр Ан будет помещен код результата 
(см. табл. 12.11). В регистр вн будет записан номер шины (от 0 до 255). 
В регистр въ будет помешен номер устройства (биты 3—7) и номер функции 
(0—2). В случае ошибки флаг ск будет установлен, иначе сброшен. Рассмот- 
рим пример для поиска основного моста хоста, приведенный в листинге 12.3. 





мох АН, ОВ1В ; код функции В1В 
поУу АГ, ОЗЬ ; код подфункции 036 
поу ЕСХ, 0600001; код класса 


моу 51, 0 ; индекс 0 

11 ТАБ ; вызываем прерывание 

стр АН, 861 ; проверяем результат операции 
пе № ЕТМР ; устройство не найдено 


; сохраняем номер шины и устройства 
поу РуЕе рЕёг МОМ ВО$, ВН 
поу Русе рёг МОМ ОЕУ, ВЬ 


12.2.4. Функция В106Р 


Данная функция позволяет сгенерировать специальный цикл для шины 
РСТ. Сгенерированный цикл будет использован на указанном номере шины. 


Использование: 
1. В регистр Ан следует поместить код функции в1ь. 


2. В регистр Ат, следует поместить код подфункции о6т. 
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3. В регистр вн следует записать номер шины (0—255). 

4. В Есх необходимо поместить данные для специального цикла шины. 
5. Вызвать прерывание 11% ЛАВ. 

Выход: 


После выполнения функции в регистр дн будет помещен код результата 
(см. табл. 12.11). В случае ошибки флаг се будет установлен, иначе сброшен. 


12.2.5. Функция В108Р 


Функция позволяет прочитать байт из конфигурационного пространства 
указанного устройства. 


Использование: 

1. В регистр Ан следует поместить код функции в1в. 

2. В регистр Ат, следует поместить код подфункции 08. 

3. В регистр вн следует записать номер шины (0—255). 

4. В регистр в. нужно записать номер устройства (биты 3—7) и номер 
функции (биты 0—2). 


5. В регистр от следует указать номер байта (регистра). Возможные значе- 
ния лежат в диапазоне от 0 до 255. 


6. Вызвать прерывание 1пе 1АВ. 


Выход: 

После выполнения функции в регистр ан будет помещен код результата 
(см. табл. 12.11), а в регистр с.— значение прочитанного байта. В случае 
ошибки флаг се будет установлен, иначе сброшен. В листинге 12.4 показан 
пример кода для получения типа заголовка (Неадег Туре). 


: Листинг 12.4. Получение описателя устройства 
; сначала следует найти устройство 
пох АН, ОВЛЬ ; код функции ВШ 


пох АБ, ОЗН ; код подфункции 038 
по\ ЕСХ, 0600001; код класса 


по эт, 0 ; индекс 0 

11 ТАБ ; вызываем прерывание 

спр АН, 86Н ; проверяем результат операции 
Эпе МО ЕТМО ; устройство не найдено 


по\ АН, ОВ ; код функции ВТ 
оу АГ, О8В ; код подфункции 086 
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поу ОТ, ОЕБ ; смещение для Неадег Туре 
108 ЛАБ ; вызываем прерывание 
с ЕВВОВ НМО; произошла ошибка 


12.2.6. Функция В109Р 


Эта функция позволяет прочитать слово (два байта) из конфигурационного 
пространства указанного устройства. 

Использование: 

1. В регистр ан следует поместить код функции в1ь. 

2. В регистр Аь следует поместить код подфункции о9в. 

3. В регистр вн следует записать номер шины (0—255). 
4 


В регистр в. нужно записать номер устройства (биты 3—7) и номер 
функции (биты 0—2). 

5. В рт следует указать смещение слова (16-битного регистра). Возможные 
значения получаются следующим образом: 0, 2, 4, 6, 8, ..., 254. 


6. Вызвать прерывание 1пе 1Ан. 


Выход: 

После выполнения функции в регистр Ан будет помещен код результата 
(см. табл. 12.11), а в регистр сх— значение прочитанного слова. В случае 
ошибки флаг сЕ будет установлен, иначе сброшен. Чтобы прочитать иден- 
тификатор производителя, выполните код из листинга 12.5. 





Листинг 12.5. Получение идентификатора производителя 


УЕМРОВ_ТР Чи ? 

; сначала следует найти устройство 

поу АН, ОВ1Ь ; код функции В1Ь 

поу АБ, ОЗВ ; код подфункции 038 

шоу ЕСХ, 0300002; код класса контроллера видеоадаптера 


поу 5Т, 0 ; индекс 0 

216 АБ ; вызываем прерывание 

сир АН, 861 ; проверяем результат операции 
пе № ЕТМР ; устройство не найдено 


поу АН, 0811 ; код функции В1Ь 

поу АЬ, О9Р ; код подфункции 098 
оу ОТ, 0 ; смещение для Уепдог ТР 
106 ТАБ ; вызываем прерывание 

3с ЕВВОВ_НМО; произошла ошибка 

; сохраняем значение идентификатора 
поу мога рег УЕМГОВ_Тр, СХ 
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12.2.7. Функция ВТОАР 


Функция позволяет прочитать двойное слово (четыре байта) из конфигура- 
ционного пространства указанного устройства. 


Использование: 

1. В регистр дн следует поместить код функции в1т. 

2. В регистр Аь следует поместить код подфункции одь. 

3. В регистр вн следует записать номер шины (0—255). 

4. В регистр вь нужно записать номер устройства (биты 3—7) и номер 
функции (биты 0—2). 

5. В рт следует указать смещение слова (32-битного регистра). Возможные 
значения получаются следующим образом: 0, 4, 8, 19, 32, ..., 252. 

6. Вызвать прерывание 1пе 1Ан. 

Выход: 


После выполнения функции в регистр Ан будет помещен код результата 
(см. табл. 12.11), а в регистр Есх— значение прочитанного слова. В случае 
ошибки флаг се будет установлен, иначе сброшен. Чтобы прочитать базовые 
адреса, можно использовать следующий код, показанный в листинге 12.6. 


; сначала следует найти устройство 


пох 
пох 
пох 
пох 
10 
стр 
Эре 


АН, ОВ ; код функции ВШ 
АГ, ОЗВ ; код подфункции 036 
ЕСХ, 0100008; код класса контроллера $С$Т 


Ут, 0 ; индекс 0 

ТАБ ; вызываем прерывание 

АН, 861 ; проверяем результат операции 
МО ЕГМО ; устройство не найдено 


; получаем базовый адрес 1 


поу 
ФА 
поу 
10 
9с 


АН, ОВ1А ; код функции ВШ 
АЬ, ОАВ ; код подфункции ОАБ 


ОТ, 10, ; смещение адреса 
ТАБ ; вызываем прерывание 
ЕВКОВ_НМ№О; произошла ошибка 


; сохраняем значение адреса 1 


пох 


Чмога рег Базе аааг 1, ЕСХ 


; получаем базовый адрес 2 


пох 
пом 


АН, 0816 ; код функции ВБ 
АГ, ОА ; код подфункции ОАБ 
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поу ОТ, 14 ; смещение адреса 

106 1АБ ; вызываем прерывание 
)с ЕВВОК_НМР; произошла ошибка 

; сохраняем значение адреса 2 

поу Чмога рёг Базе аЧ@Чг 2, ЕСХ 

; получаем базовый адрес 3 

поУ АН, ОВ1р ; код функции В 

поу АЬ, ОАН ; код подфункции ОАВ 
поу ОТ, 18В ; смещение адреса 

116 1АВ ; вызываем прерывание 
с ЕВВОВ НМ; произошла ошибка 

; сохраняем значение адреса 3 

поу Чмога рёг Базе аааг 3, ЕСХ 

; получаем базовый адрес 4 

поу АН, ОВ1Ь ; код функции ВТ 
поу АБ, ОАВ ; код подфункции ОАВ 
поу ОТ, 1СЬ ; смещение адреса 

11 ТАБ ; вызываем прерывание 
с ЕВВОВ НМО; произошла ошибка 

; сохраняем значение адреса 4 

поу @могЯ рег Базе _аЧаг 4, ЕСХ 

; получаем базовый адрес 5 

поу АН, ОВ1В ; код функции В1В 
поу АЬ, ОАН ; код подфункции ОАБ 
шоу ОТ, 20. ; смещение адреса 

118 ТА ; вызываем прерывание 
с ЕВВОВ НМО; произошла ошибка 

; сохраняем значение адреса 5 

поу @мога рёг Базе_аЧЧг 5, ЕСХ 

; получаем базовый адрес 6 

поу АН, ОВ1Ь ; код функции ВШ 
поу АЬ, ОАВ ; код подфункции ОАВ 
шоу ОТ, 24р ; смещение адреса 

118 ТАБ о } вызываем прерывание 
с ЕВВОК НМО; произошла ошибка 

; сохраняем значение адреса 6 

поу амога рёг Базе аааг 6, ЕСХ 


12.2.8. Функция ВТОВР 


Данная функция позволяет записать один байт в конфигурационное про- 
странство указанного устройства. 
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Использование: 
1. В регистр ан следует поместить код функции в1н. 


2. В регистр Ат, следует поместить код подфункции овь. 
3. В регистр вн следует записать номер шины (0—255). 
4 


. В регистр вь нужно записать номер устройства (биты 3—7) и номер 
функции (биты 0—2). 


5. В регистр от следует указать номер байта (регистра). Возможные значе- 
ния лежат в диапазоне от 0 до 255. 


6. В регистр сь следует записать значение байта. 
7. Вызвать прерывание зпе 1АВ. 


Выход: 


После выполнения функции в регистр ан будет помещен код результата 
(см. табл. 12.11). В случае ошибки флаг се будет установлен, иначе сброшен. 


12.2.9. Функция ВТОСВ 


Функция позволяет записать одно слово (два байта) в конфигурационное 
пространство указанного устройства. 


Использование: 

1. В регистр ан следует поместить код функции в1в. 

2. В регистр АЬ следует поместить код подфункции о9в. 
3. В регистр вн следует записать номер шины (0—255). 
4 


. В регистр вь нужно записать номер устройства (биты 3—7) и номер 
функции (биты 0—2). 


5. В регистр рт следует указать смещение слова (16-битного регистра). Воз- 
можные значения получаются следующим образом: 0, 2, 4, 6, 8, ..., 254. 


6. В регистр сх следует записать значение слова. 
7. Вызвать прерывание 1пе 1АЬ. 
Выхол: 


После выполнения функции в регистр Ан будет помещен код результата 
(см. табл. 12.11). В случае ошибки флаг се будет установлен, иначе сброшен. 


12.2.10. Функция В100В 


Данная функция позволяет записать двойное слово (четыре байта) в конфи- 
гурационное пространство указанного устройства. 
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Использование: 

1. В регистр Ан следует поместить код функции в1в. 

2. В регистр АЬ следует поместить код подфункции ов. 
3. В регистр вн следует записать номер шины (0—255). 
4 


. В регистр вь нужно записать номер устройства (биты 3—7) и номер 
функции (биты 0—2). 


5. В регистр от следует указать смещение слова (32-битного регистра). Воз- 
можные значения получаются следующим образом: 0, 4, 8, 19, 32, ..., 252. 


6. В регистр ЕСх следует записать значение двойного слова. 
7. Вызвать прерывание 11+ ТАН. 


Выход: 


После выполнения функции в регистр Ан будет помещен код результата 
(см. табл. 12.11). В случае ошибки флаг се будет установлен, иначе сброшен. 


Чтобы использовать функции записи РСГ ВО$, необходимо иметь доку- 
ментацию на программируемое устройство. 


На этом мы завершим описание функций В1О$ и перейдем к непосредст- 
венному программированию портов ввода-вывода. 


12.3. Использование портов 


Представленный здесь материал основывается на устройствах фирмы Шше|. 
Любую дополнительную информацию по данной теме можно свободно най- 
ти на сайте этого производителя (м\у\у ле]. сот). Как правило, для доступа к 
шине РС! используются адреса осЕВь—ОСЕЕв. За определенными адресами 
закреплены аппаратные регистры, позволяющие получить доступ к разно- 
образным устройствам на шине РСТ. Рассмотрим их подробнее. 


12.3.1. Регистр конфигурации адреса 


Данный регистр расположен по адресу осе8ь. Этот 32-разрядный регистр 
доступен для чтения и записи. Он позволяет определить конфигурационные 
параметры устройства на шине РС], а также номер регистра для последую- 
щего доступа к устройству. Формат этого регистра показан в табл. 12.12. По 
умолчанию значение регистра равно 00000000. 


Таблица 12.12. Формат регистра конфигурации адреса 


Бит Описание 
0—1 Резерв 


2-7 Определяют значение регистра для доступа к устройству 
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Таблица 12.12 (окончание) 


Бит Описание 


8—10 Номер функции для многофункционального устройства. 
11—15 — Номер устройства на шине РС! 

16—23 — Номер шины РС! 

24—30 — Резерв 


31 Установка этого бита в 1 разрешает доступ к конфигурационному про- 
странству шины РС1, иначе доступ заблокирован (бит равен 0) 


12.3.2. Регистр конфигурации данных 


Регистр расположен по адресу осЕсь. Этот 32-разрядный регистр доступен 
для чтения и записи. Он предназначен для чтения или записи данных в 
конфигурационное пространство шины РС]. Для обмена данными исполь- 
зуются все биты (0—31). 


С помощью этих двух регистров можно получить доступ к любому устрой- 
ству на шине. Для этого в регистр адреса следует записать параметры уст- 
ройства и после этого можно читать и писать данные через регистр данных. 
Рассмотрим пример кода для сканирования шины РС], представленный 
в листинге 12.7. 


Листинг 12.7. Сканирование шины РС! 





#1ос1аае "зЕЗаЕх.В" 
// определяем значения смещений для пространства шины РСТ 


#ЧеЕ1пе УЕМРОВ_ тр 90х00 
#ЧеЕ1пе РЕУТСЕ ТР 0х02 
#АеЕ1пе СОРЕ 0х04 
#АеЁЕ1пе ЗТАТОЗ 0х06 
#АеЕ1пе ВЕУТЗТОМ ТР 0х08 
#АеЕ1пе ТМТЕВЕАСЕ 0х09 
#АеЕ1пе ЗОВСТА$ $ 0х0А 
#АеЕ1пе СТАЗЗСОВЕ 0хов 
#ЧеЕ1пе САСНЕ ЪТМЕ 517Е — 0х0С 
#ЧеЕ1пе ГАТЕМСУ ТТМЕВ 0%00 
#ЧеЁ1пе НЕАРЕВ ТУРЕ 0хОЕ 
#АеЕзпе ВТУТ ОхоЕ 
$ЧеЁ1пе ВАЗЕ АРРВЕ$5_0 0х10 
#4еЁ1пе ВАЗЕ АРОВЕЗ$ 1 0х14 


#ЧеЕ1пе ВАЗЕ_АРОВЕ$$_2 0х18 
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#ЧеЕ1пе ВАЗЕ АБРВЕ$$_3 0х1С 
#$АеЁ1пе ВАЗЕ АРОВЕ$$ _4 0х20 
4ЧеЕ1пе ВАЗЕ АБОВЕЗ$_5 0х24 
фаеЕ1пе САВОВО$ РОТМТЕВ 0х28 
#ЧеЕ1те ЗОВУЕМ Тр 0х2С 
#аеЕ1пе ЗИВЗУЗТЕМ ТР 0х2Е 
}ЧеЕ1пе ВОМ ВАЗЕ_АРРВЕЗ$$ 0х30 
#ЧеЕ1пе ТМТЕВВОРТ_ЬТМЕ 0х3С 
#+АеЕ1пе ТМТЕВВОРТ РТМ 0х3В 
#ЧеЕ1пе МТМ СМТ ОхЗЕ 
#аеЁ1пе МАХ ТАТ ОхЗЕ 


// функция для сканирования шины РСТ 
у01А ЗсапРСТ ( 106 1Ва$РСТ); 
// определение номера слота для устройства 
116 Себреу1себ1ое ( 106 1Юе\у1се, 10Е 1Рарсе1оп); 
// получаем конфигурационные параметры для устройства 
РМОВР Сеёреу1се ( 1пе 1ВазРСТ, 116 15106, 1106 1АЗагез$); 
// реализуем наши функции 
11 Сеереу1се$1оЕ ( 1пЕ 1Шеу1се, 116 1РЕапсе1оп) 
{ 
хебатп ( ( ( ( 1Шеу1се) & 0х1Е) << 3) | ( ( 1Ролсб1ор) & 0х07)); 
} 
РМОВР Сеереу1се ( 1п6 1Ва5$РСТ, 1пЕ 15106, 116 1АЗагез$) 
{ 
гебагп ( 0х800000001, | ( ( 1Ва5 & ОхЕЕ) << 16) | ( 13106 << 8) | 
( 1АЧакез$$ & -3)); 
} 
// единственный аргумент функции определяет номер шины ( от 0 до 255) 
\У01А ЗсапРСТ ( 116 1ВазРСТ) 
{ 
РМОВР ЧмВези1е = 0; 
ВУТЕ БаЕЁЕег [256]; 
// создаем двойной цикл для перебора всех устройств 
Бог ( 116 10еу1се = 0; 1Беулсе < 32; 10еу1се++) 
{ 
Бог ( 10 1ЕКарсё1юоп = 0; 1Рорсё1оп < 8; 1Еапсё10п++) 
{ 
пемзее ( &риЕЁЕег, 0, 256); 
// вычисляем номер очередного слота 
106 15106 = бсееМ№ал$1ое ( 10еу1се, 1Еопс®1оп); 
// проверяем поле Уепдок ТР для определения наличия устройства 
РИОВР ЧмУепаокТЬ = 0; 
// получаем конфигурацию устройства 
ЧиВезо1е = беёре\у1се ( 1ВазРСТ, 1510, УЕМРОВ_ТР); 


Глава 12. Пространство шины РС! 477 


// пишем в адресный порт параметры устройства 
оцЕРохе ( ОхСЕ8, амВезы1, 4); 
ЧчВеза1е = 0; 
// читаем из порта данных идентификатор производителя 
1пРохгЕ ( ОХСЕС, &АмВезо1е, 4); 
// если полученное значение равно 0 или ОхЕГЕЕЕЕЕЕ, 
// выходим из вложенного цикла и продолжаем поиск 
1Е ( ЧмУепаокТР == 0х00000000 || амУепаогтТР == ОхЕРЕЕЕЕЕЕ) 
Ьгеак; 
// если устройство присутствует, читаем его параметры 
// из конфигурационного пространства шины РСТ 
Бог (116 ) = 1; ) < 256; 9++) 
{ 
// получаем конфигурацию устройства 
ЧмВези1е = бесреу1се ( 1ВазРСТ, 1$10%, 1); 
// пишем в адресный порт параметры устройства 
оцЕРоге ( ОхСЕ8, амВеза\, 4); 
// получаем из порта очередной байт 
1пРог® ( ОхСЕС + ( ]&0х03), &амВези1, 1); 
// сохраняем полученный байт в буфер 
раЕЕехг{)] = дВезо1; 
// здесь мы можем извлечь нужные данные из буфера и сохранить 
// их для последующего использования 
// например, получим номер прерывания для устройства 
// переменная ЗТМТ определена где-то ранее 
иТМТ = БаЕЕех [ТМТЕВВОРТ ГТМЕ]; 
// поле Неааех Туре 
иНеаЧег = раЕЁЕег [НЕАРЕВ_ ТУРЕ]; 
// поле Веу1з1оп ТР 
иВехтТр = БаЕЕех [ВЕУТЗТОМ ТО]; 
// поле Бе\у1се Тр 


Чмрех1сетр = ( ( МОВО) ( ( ( ВУТЕ) ( БоЕЕех [РСТ _РЕУТСЕ_ТО]) 
1 ( ( МОВЬ) ( ( ВУТЕ) ( БаЕЕех [РСТ_РЕУТСЕ_ТЬ] + 1)))} << 8))); 

// поле Соае 

Чмсоае = ( { МОВО) ( ( ( ВУТЕ) ( БаЕЕек [СОПЕ])) 

| ( ( (ОВО) ( ( ВУТЕ) ( БаЕЕех [СОРЕ] + 1))) << 8))); 

// поле ЗаБзузсем Уепаог ТР 

ЧизаюУепаогТР = ( ( МОВР) ( ( ( ВУТЕ) ( БаЕЕег[$О0ВУЕМ ТЬ])) 

ГС ( ( ИОВО) ( ( ВУТЕ) ( БаЕЕег [З0ВУЕМ ТО] + 1))) << 8))); 


// базовый адрес 0 

МОВР 1ом = 0, В1ай = 0; 

// получаем младшее слово адреса 

1ом = ( ( МОВЬ) ( ( ( ВУТЕ) ( БоЕЕег [ВАЗЕ_АРОВЕ$5_0})) 
Г (( ( ОВО) ( ( ВУТЕ) ( БаЕЁег [ВАЗЕ АББВЕ$$ 0] + 1))) << 8))); 
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// получаем старшее слово адреса 
ЬЗ90 = ( ( МОВО) ( ( { ВУТЕ) ( БаЕЕех [ВАЗЕ АОБВЕЗ$ 0] + 2)) 
ГС ( ( ИОВО) ( ( ВУТЕ) ( БаЕЕех [ВАЗЕ АББВЕ$$ 0] + 3))) << 8))); 
// вычисляем полный адрес 
ЧмВазеАЯЯгезз 0 = ( ( 10№6) ( ( ( МОВО) ( 10м)) | 
( ( ( РМОВЬ) ( ( МОВЬ) ( 51910))) << 16))); 


} 

// пример вызова функции ЗсапРСТ для первой шины 
ЗсапРСТ (0); 

// пример вызова функции ЗсапРСТ для второй шины 
ЗсапРСТ (1); 


Итак, наша функция $сапрст имеет всего один аргумент, в качестве которо- 
го используется номер шины РС|. Из примера видно, что, работая всего с 
двумя портами ОСЕЗв и оСЕСв, мы получили возможность доступа ко всем 
устройствам компьютера. Кроме общих сведений о каждом устройстве, нам 
удалось определить базовые адреса ввода-вывода и номер прерывания. Од- 
нако следует заметить, что далеко не все устройства возврашают номер пре- 
рывания. Это связано с тем, что наряду с привычными модулями (видео- 
контроллер, 1ШЕ или звуковой контроллер) возвращаются данные о спепци- 
фических устройствах, например о мостах, ЧЗВ-контроллерах и др., 
использующих совершенно отличные принципы работы. 


Фирмы ше] и Ма на своих сайтах предоставляют самую свежую информа- 
цию о новых устройствах и наборах микросхем (сП1рзе!). В этой документа- 
ции содержится подробная информация о доступе и управлении устройст- 
вами посредством конфигурационного пространства шины РСТ. Поскольку 
каждый новый набор микросхем имеет свои особенности, рекомендую чи- 
тателям постоянно следить за этой информацией. 


Давайте в качестве примера рассмотрим конфигурационное пространство 
шины РС для современного контроллера 1РЕ фирмы Пие. Формат кон- 
троллера (256 байт) представлен в табл. 12.13. 


Таблица 12.13. Контроллер РЕ фирмы п! 


Смещение Описание 
00н—о1н \Уепдог 0 
025—03в Оемсе р 


045-05. Командный регистр 
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Смещение 


061—078 
08 


ОЕ 
105—130 
145—178 
185-—1в 
1—1 
20.—23в 
245—278 
28—28 
268—208 
2ЕВ—2ЕВ 
241—ЗВЬ 
св 
Зрь 
ЗЕ 
405—418 
42—43 
44в 
455—476 
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4АВ—4ВЬ 


Описание 

Зам $ 

Аемзюп 02 

Интерфейс 

Код подкласса 

Код базового класса 

Резерв 

ЁЕаепсу Титег 

Неачег Туре 

Резерв 

Базовый адрес для первого канала 
Базовый адрес для первого канала 
Базовый адрес для второго канала 
Базовый адрес для второго канала 
Адрес регистра для шины ОЕ 
Расширения 

Резерв 

Зибзу ет Мепдог 0 

Зибзу ет 10 

Резерв 

1щеггир* Ипе 

1\еггир* Рт 

Резерв 

Синхронизация для первого канала 


Синхронизация для второго канала 
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Таблица 12.13 (продолжение) 


Синхронизация для ведомого устройства на первом и втором каналах 


Резерв 
Управляющий регистр Уйга ОМА 
Резерв 


Регистр синхронизации Цйга ОМА 
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Таблица 12.13 (окончание) 


Смещение Описание 


4с—53В 


545—551 


568—Е7\ 


Е8—ЕВБ 


ЕСИ ЕЕВ 


Резерв 

Конфигурация ввода-вывода 
Резерв 

Идентификатор производителя 


Резерв 


Приведем краткое описание таблицы. 


О 00-:—01в — идентификатор производителя. Только для чтения. Всегда бу- 
дет равен значению 80861. 


О 


025—038 — идентификатор изделия. Только для чтения. Возможны сле- 
дующие значения: 


® 24111 — контроллер АТА (82801АА); 
® 2421. — контроллер АТА (82801АВ); 
® 244Ав — контроллер АТА для мобильных ПК (82801ВА); 


® 244Вн — контроллер АТА для высокопроизводительных ПК (82801ВА); 


® 248Ав — контроллер АТА для мобильных ПК (82801СА); 


® 248В. — контроллер АТА для высокопроизводительных ПК (82801СА); 


® 24САв — контроллер АТА для мобильных ПК (8280108); 


® 24СВь — контроллер АТА для высокопроизводительных ПК (82801СА); 


® 2408. — контроллер АТА для высокопроизводительных ПК (82801ЕВ). 


04.— 05. определяют управляющий регистр. Для чтения и записи. Формат 
регистра показан в табл. 12.14. 


Бит 


3—15 


Таблица 12.14. Формат управляющего регистра 
Описание 
Управление операциями ввода-вывода (1 — разрешить, 0 — запретить) 
Управление доступом к памяти (1 -- разрешить, 0 -- запретить) 
Управление шиной (1 — включить, 0 — выключить) 


Зарезервированы и равны 0 
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О 06—07. определяют регистр состояния. Доступен для чтения и записи. 


О ов» — номер версии устройства. Только для чтения. 


О оэь определяет интерфейсный регистр. Для чтения и записи. Формат ре- 


Я 


О 
О 


Бит 


гистра показан в табл. 12.15. 


Таблица 12.15. Формат интерфейсного регистра 


Описание 


Выбор режима для первичного канала (1 — использовать совместимый, 
0 —- использовать "родной" РС) 


Поддержка режима на первичном канале (1 — использовать совмести- 
мый 
мн 


и "родной", 0 — только совместимый) 


Выбор режима для вторичного канала (1 — использовать совместимый, 
0 — использовать "родной" РС|) 


Поддержка режима на вторичном канале (1 — использовать совместимый 
и "родной", 0 — только совместимый) 


Если бит 7 равен 1, используется "родной" режим шины РС, иначе — 
совместимый 


Управляет значением битов 4—6 


оАв определяет код подкласса для устройства. Только для чтения. 
овь определяет код базового класса для устройства. Только для чтения. 


орь определяет время ожидания для ведушего устройства на шине РС. 
Доступен для чтения и записи. 


ОЕЬ определяет многофункциональное устройство. Только для чтения. 


10.—13Ъ, 145—17ь, 185—1ВЬ, 1С6-—1ЕВ и 20.—23. определяют базовые ад- 


реса каналов. Доступны для чтения и записи. Формат регистров показан 
в табл. 12.16. 


Таблица 12.16. Формат регистра базового адреса 


Бит Описание 
0 Тип ресурса (должен быть равен 1}, только для чтения 
1—3 — Зарезервированы и должны быть установлены в 000% 


4—31 — Значение базового адреса ввода-вывода 


[№ 


[№ 
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245—27ь определяют базовый адрес ввода-вывода в памяти. Доступны для 
чтения и записи. Формат регистров показан в табл. 12.17. 


Таблица 12.17. Формат регистра адреса, расположенного в памяти 
Бит Описание 


0 Тип ресурса (должен быть равен 0), только для чтения 


1—2 32-разрядный тип отображения в памяти (должен быть равен 0), 
только для чтения 


3 0 


4—31 — Значение базового адреса ввода-вывода в памяти 


2с5—206 определяют дополнительный идентификатор производителя, ко- 
торый доступен для чтения и однократной записи (для повторной записи 
придется перезагрузить компьютер). По умолчанию значение этого реги- 
стра равно 0. 


2ЕВ—2ЕВ определяют идентификатор подсистемы. Доступен для чтения и 
однократной записи (для повторной записи придется перезагрузить ком- 
пьютер). По умолчанию значение этого регистра равно 0. 


зсь определяет номер выделенного прерывания. Достуйен для чтения и 
однократной записи (для повторной записи придется перезагрузить ком- 
пьютер). По умолчанию значение этого регистра равно 0. 


Зрь определяет дополнительные опции линии прерывания для контрол- 
лера. Только для чтения. Используется в стандартном режиме работы 
шины РСТ. По умолчанию значение этого регистра равно 0. 


409—418 И 425—435 управляют режимом синхронизации контроллера. 
Доступны для чтения и записи. Формат регистра показан в табл. 12.18. 


Таблица 12.18. Формат регистра синхронизации контроллера 


Бит Описание 


0 Использование ускоренной синхронизации для первого канала 
(1 — включить, 0 — выключить} 


1 Использование сигнала 1ОВО\ для первого канала 
(1 — включить, 0 — выключить} 


2 Использование упреждения для первого канала (1 — включить, 
0 — выключить} 


3 Использование синхронизации с ОМА для первого канала 
{1 — включить, 0 — выключить} 
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Таблица 12.18 (окончание) 





Бит Описание 





4 Использование ускоренной синхронизации для второго канала 
{1 — включить, 0 — выключить) 


5 Использование сигнала 1ОВО\У для второго канала (1 — включить, 
0 — выключить} 


6 Использование упреждения для второго канала (1 — включить, 
0 — выключить} 


7 Использование синхронизации с ОМА для второго канала 
(1 — включить, 0 — выключить} 


8—9 Время восстановления (001 — 4 такта, 01. — 3 такта, 10. — 2 такта, 
118 — 1 такт) 


10—11  Зарезервированы и должны быть установлены в оон 


12—13 Частота сигнала 1ОНОУ (001 — 5 тактов, о1ь —- 4 такта, 105 — 3 такта, 
11. — 2 такта) 


14 Управление регистром синхронизации для ведомого устройства 
(1 — включить, 0 — выключить} 


15 Использование декодирования для ШЕ (1 — включить, 
0 —- выключить} 


С 44. управляет параметрами синхронизации для обоих каналов. Доступен 
для чтения и записи. Формат регистра показан в табл. 12.19. 


Таблица 12.19. Формат регистра 445 





Бит Описание 


0—1 — Время восстановления для первого ведомого канала (00 — 4 такта, 
01. — Зтакта, 10. — 2 такта, 115 — 1 такт) 


2—3 Частота сигнала ЮНОУ для первого ведомого канала (00 — 5 тактов, 
01: — 4 такта, 10. — 3 такта, 11. — 2 такта) 


4—5 — Время восстановления для второго ведомого канала (001 — 4 такта, 
01. — Зтакта, 105 — 2 такта, 11. — 1 такт) 


6—7 Частота сигнала ЮНОУ для второго ведомого канала (001 — 5 тактов, 
011 — 4 такта, 10 — З такта, 11. — 2 такта) 


С 4вь определяет параметры синхронизации для режима Ога ОМА. Досту- 
пен для чтения и записи. Формат регистра показан в табл. 12.20. 
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Таблица 12.20. Формат регистра 481 


Бит Описание 


0 Управление режимом Уйга ОМА для первого устройства на первом канале 
{1 — включить, 0 — выключить} 


1 Управление режимом Цга ОМА для второго устройства на первом канале 
| {1 — включить, 0 — выключить} 


2 Управление режимом ЦИЁга ОМА для первого устройства на втором канале 
(1 — включить, 0 — выключить) 


3 Управление режимом Иа ОМА для второго устройства на втором канале 
(1 — включить, 0 — выключить) 


4—7 — Зарезервированы и должны быть установлены в 00008 


О 4А-—4вв определяют дополнительные параметры синхронизации для ре- 
жима Чиа ОМА. Доступны для чтения и записи. 


О 54.—555 определяют конфигурацию контроллера. Доступны для чтения и 
записи. Формат регистра показан в табл. 12.21. 


Таблица 12.21. Формат регистра конфигурации контроллера 


Бит Описание 


0 Частота для первого диска на первом канале {1 — 66 МГц, 0 — 33 МГц) 
1 Частота для второго диска на первом канале (1 -- 66 МГц, 0 — 33 МГц) 
2 Частота для первого диска на втором канале (1 — 66 МГц, 0 — 33 МГц) 
З Частота для второго диска на втором канале (1 — 66 МГц, 0 — 33 МГц) 
4 


Тип используемого кабеля для первого диска на первом канале 
{1 — 80 жил, 0 — 40 жил) 


5 Тип используемого кабеля для второго диска на первом канале 
(1 — 80 жил, 0 — 40 жил) 


6 Тип используемого кабеля для первого диска на втором канале 
(1 — 80 жил, 0 — 40 жил) 


7 Тип используемого кабеля для второго диска на втором канале 
(1 — 80 жил, 0 -— 40 жил) 


8—9 — Зарезервированы и должны быть установлены в 00% 


10 Эффективность передачи данных для режима РО (1 — включить, 
0 — выключить) 


11 Зарезервирован и должен быть установлен в оъ 
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Таблица 12.21 (окончание) 





Бит Описание 


12 — Повышение частоты для первого диска на первом канале 
{1 — 100 МГц, 0 — 33 или 66 МГц) 


13 — Повышение частоты для второго диска на первом канале 
(1 — 100 МГц, 0 — 33 или 66 МГц) 


14 — Повышение частоты для первого диска на втором канале 
{1 — 100 МГц, 0 — 33 или 66 МГц) 


15 — Повышение частоты для второго диска на втором канале 
{1 — 100 МГц, 0 — 33 или 66 МГц) 


0 гзь—ЕВь определяют дополнительный идентификатор производителя. 
Только для чтения. 


Как видите, структура описания контроллера ШОЕ полностью оговаривает 
все необходимые для работы с дисками параметры. Вам достаточно найти 
данное устройство на шине РСТ (используя функцию зсапрст) и сохранить 
базовые адреса и требуемую информацию. После этого можно спокойно 
работать с диском посредством набора команд АТА/АТАРРИ. 


ГЛАВА 13 


Контроллер ОМА 


Контроллер прямого доступа к памяти (ОМА — Опесё Метоту Ассез5) пред- 
назначен для обмена данными между оперативной памятью и устройством 
без помощи центрального процессора. Это значит, что во время операций 
чтения или записи с использованием каналов РМА процессор свободен и 
может обрабатывать другие данные, что ошутимо увеличивает общую про- 
изводительность компьютера. 


Контроллер МА реализован на основе микросхемы 8237 (8237А). Она со- 
держит четыре независимых канала. Число каналов может быть увеличено 
за счет каскадного подключения дополнительных микросхем 8237. Как пра- 
вило, в компьютере имеется два контроллера: первый 8-разрядный (поддер- 
живает каналы 0, 1, 2 и 3) и 16-разрядный (поддерживает каналы 4, 5, 6 
и 7). Первый позволяет адресацию до |1 Мбайт памяти, а второй — до 
16 Мбайт. Кроме того, первый канал поддерживает адресуемые блоки раз- 
мером 64 Кбайт, а второй — 128 Кбайт, поэтому при передаче данных сле- 
дует контролировать границы адресуемых участков. Контроллер ОМА под- 
держивает четыре режима работы: 


1. Одиночная передача данных. 

2. Передача данных блоками. 

3. Передача данных по внешнему запросу. 
4. Каскадный режим работы. 


Первый канал ОМА (0) используется для регенерации обновления памяти, 
и его не рекомендуется программировать. Второй канал (1) поддерживает 
работу с контроллером гибких дисков. Третий канал РОМА (2) отведен для 
параллельного порта принтера (ЕСР). Четвертый выполняет роль связующе- 
го со вторым контроллером: ОМА с помошью метода каскадирования. Для 
доступа к контроллеру применяются порты, перечисленные в табл. 13.1. 
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Таблица 13.1. Список портов для работы с контроллером ОМА 





Номер 





порта Описание 
о0в Регистр данных канала 0 
011 Регистр числа обработанных байтов канала 0 
021 Регистр данных канала 1 
озп Регистр числа обработанных байтов канала 1 
04ь Регистр данных канала 2 
058 Регистр числа обработанных байтов канала 2 
06 Регистр данных канала 3 
078 Регистр числа обработанных байтов канала 3 
о8в Управляющий регистр (запись) и регистр состояния (чтение) для ОМА-1 
09в Регистр запроса для ОМА-1 
ОП Регистр маски для ОМА-1 
ОвВ Регистр режима работы ОМА-1 
осп Регистр сброса триггера ОМА-1 
ов Регистр сброса контроллера ОМА-1 
ОЕБ Регистр сброса маскирующих битов ОМА-1 
ОЕ Регистр установки масок для всех каналов ОМА-1 
811 Регистр адреса страницы канала 2 
821 Регистр адреса страницы канала 3 
83В Регистр адреса страницы канала 1 
878 Регистр адреса страницы канала 0 
89в Регистр адреса страницы канала 6 
ВАВ Регистр адреса страницы канала 5 
8ВВ Регистр адреса страницы канала 7 
ЗЕ Регистр обновления памяти 
сов Регистр данных канала 4 
С26 Регистр числа обработанных байтов канала 4 
С4в Регистр данных канала 5 
сев Регистр числа обработанных байтов канала 5 
св Регистр данных канала 6 
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Таблица 13.1 (окончание) 





Номер Описание 
порта 
САВ Регистр числа обработанных байтов канала 6 
ССВ Регистр данных канала 7 
СЕВ Регистр числа обработанных байтов канала 7 
ров Управляющий регистр (запись) и регистр состояния (чтение) для ОМА-2 
02 Регистр запроса для ОМА-2 
04в Регистр маски для ОМА-2 
06В Регистр режима работы ОМА-2 
ОН Регистр сброса триггера ОМА-2 
РАВ Регистр сброса контроллера ОМА-2 
ОСП Регистр сброса маскирующих битов ОМА-2 
РЕр Регистр установки масок для всех каналов ОМА-2 





Передача данных через порты 00,—07ь происходит в два этапа: первые 8 бит 
(0—7) и вторые 8 бит (8—15). Связано это с тем, что регистры 8-разрядные. 
Кроме того, эти порты доступны для чтения и записи. В режиме чтения они 
возвращают младший (008, 02н, 04в и 06.) и старший (01, озь, о5в и 078) 
байты для текущего адреса в соответствующем канале ОМА-1. 


Порты сон—СЕВ доступны для чтения и записи. В режиме чтения они воз- 
вращают младший (сон, сан, с8н и ссь) и старший (с2ь, сев, сав и сЕв) байты 
для текущего адреса в соответствующем канале ОМА-2. 


Порты 085 (ОМА-1) и ов (РМА-2) в режиме записи используются как 
управляющие, а в режиме чтения возвращают текущее состояние. Размер 
обоих регистров составляет 8 бит. Они позволяют настроить работу всех че- 
тырех каналов. Регистры состояния также имеют размер 8 бит и помогают 
получить состояние каналов контроллера. Формат регистра управления по- 
казан в табл. 13.2, регистра состояния — в табл. 13.3. 


Таблица 13.2. Формат управляющего регистра для ОМА-1 и ОМА-2 


Бит Описание 


0 Режим память-память (1 — включен, 0 — выключен) 


1 Удержание канала 0 (1 — включено, 0 — выключено). Если бит 0 равен 0, не 
используется 


2 Управление контроллером (1 — выключен, 0 — включен) 
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Таблица 13.2 (окончание) 
Описание 


Режим сжатия по времени (1 — включен, 0 — выключен). Если бит 0 равен 1, 
не используется 


Управление приоритетом (1 — с чередованием, 0 — фиксированный) 


Цикл записи (1 — расширенный, 0 — с запаздыванием). Если бит 3 равен 1, 
не используется . 


Сигнал ОВЕС (1 — выключен, 0 — включен) 


Сигнал ОАСК (1 — выключен, 0 — включен) 


Таблица 13.3. Формат регистра состояния для ОМА-1 и ОМА-2 


Описание 

Завершена работа ОМА режима для канала 0 (4), если значение равно 1 
Завершена работа ОМА режима для канала 1 (5), если значение равно 1 
Завершена работа ОМА режима для канала 2 (6), если значение равно 1 
Завершена работа ОМА режима для канала 3 (7), если значение равно 1 
Получен запрос для канала 0 (4), если значение равно 1 

Получен запрос для канала 1 (5), если значение равно 1 

Получен запрос для канала 2 (6}, если значение равно 1 


Получен запрос для канала 3 (7), если значение равно 1 


Порты оэь (ОМА-1) и 2. (ОМА-2) используются только в режиме записи и 
позволяют установить сигнал запроса на указанном канале. Размер обоих 
регистров составляет 4 бита. Формат регистра запроса показан в табл. 13.4. 


Таблица 13.4. Формат регистра запроса для ОМА-1 и ОМА-2 
Описание 


Выбор канала для сигнала запроса (005 — канал 0 или 4, о1ь — канал 1 
или 5, 105 — канал 2 или 6, 11ь — канал 3 или 7) 


Управление сигналом запроса (1 — установить, 0 — сбросить} 


Игнорируются 
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Порты ов (ОМА-1) и р4ь (ОМА-2) используются только в режиме записи и 
позволяют установить бит маски на указанном канале для блокировки сиг- 
нала ОКЕО. Размер обоих регистров составляет 4 бита. Формат регистра 
маски показан в табл. 13.5. 


Таблица 13.5. Формат регистра маски для ОМА-1 и ОМА-2 


Бит Описание 


0—1 — Выбор канала для сигнала запроса (00 — канал 0 или 4, 01ь — канал 1 
или 5, 105 — канал 2 или 6, 115 — канал 3 или 7) 


2 Управление битом маски (1 — установить, 0 — сбросить) 


3—7 — Игнорируются 


Порты овь (ОМА-1) и овь (ОМА-2) используются только в режиме записи и 
позволяют настроить режим работы контроллера для указанного канала. 
Номер канала устанавливается в самом регистре (биты 0 и 1). Размер обоих 
регистров составляет 6 бит. Формат регистра режима показан в табл. 13.6. 


Таблица 13.6. Формат регистра режима для ОМА-1 и ОМА-2 


Бит Описание 


0—1 Выбор канала для сигнала запроса (005 — канал 0 или 4, оль-- канал 1 
или 5, 105 — канал 2 или 6, 115 — канал 3 или 7) 


2—3 Режим передачи данных (005 — с проверкой, о1ь— запись, 105 — чтение, 
116 — недопустимый). Если биты 6 и 7 установлены в 1, данное поле не ис- 
пользуется 


Автоинициализация (1 — включить, -0 — выключить) 
Изменение значения адреса (1 — уменьшение, 0 — увеличение) 


6—7 Выбор режима работы (006 — передача по запросу, о1ь — одиночная переда- 
ча, 106 — передача блоками, 115 — каскадный режим) 


Порты осн (ОМА-1) и р8ь (ОМА-2) используются только в режиме записи и 
позволяют включить использование портов 00—07н для работы с 16-раз- 
рядными значениями. Вначале нужно будет прочитать младший байт, а за- 
тем старший. 


Порты орь (ОМА-1) и рав (ОМА-2) позволяют выполнить сброс контролле- 
ра ОМА. Для этого следует записать в эти порты любое значение. 


Порты ов (ОМА-1) и ось (ОМА-2) позволяют выполнить сброс битов мас- 
ки для всех каналов. Для этого следует записать в эти порты любое зна- 
чение. 
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Порты огь (ОМА-1) и Ев (ОМА-2) позволяют выполнить установки битов 


маски для всех каналов. Формат регистра установки маски показан в 
табл. 13.7. 


Таблица 13.7. Формат регистра установки бита маски для всех каналов 


Бит Описание 


0 Бит маски для канала 0 (4) установлен, если значение равно 1, 
иначе сброшен 


1 Бит маски для канала 1 (5) установлен, если значение равно 1, 
иначе сброшен 


2 Бит маски для канала 2 (6) установлен, если значение равно 1, 
иначе сброшен 


3 Бит маски для канала 3 (7) установлен, если значение равно 1, 
иначе сброшен 


4—7 — Зарезервированы и должны быть установлены в 0 


Вот и все базовые сведения о контроллере ОМА. Рассмотрим пример, по- 
зволяющий выполнить сброс контроллера ОМА-2 (листинг 13.1). 


Везее0МА2 ргос 

поу АБ, 01А ›; сюда можно записать любое значение 
оцЕ ОРАБ, АБ ; сбрасываем контроллер РМА-2 

ге 

ВезесПМА2епар 


Аналогичный пример для С+- представлен в листинге 13.2. 


// пишем функцию для сброса контроллера ПМА 
у01А Везе рМА ( ипз1дпеЯя 10 о ОМА) 


{ 
1Е ( ( о/бМА == 0) || ( оОМА > 2) гебагп; 
1Е ( -«ОМА == 1) // ОМА-1 
оиЕРоге ( 0х0, 0х01, 1); // выполняем сброс 
е!1зе // ОМА-2 
опЕРоге ( ОхрА, 0х01, 1); // выполняем сброс 
} 


// сбрасываем контроллер РМА-1 
ВезеерМА (1); 
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Рассмотрим еще один пример для определения доступности канала 3 на 
контроллере ОМА-1, представленный в листинге 13.3. 


истинг 13.3. Проверка готовности канала ОМА 





ТзВеааурМА_3 ргос 

хог АБ, АБ ; обнуляем регистр 

10 АБ, 085 $; читаем байт статуса 

$езе АГ, 80Н ; проверяем бит 7 

312 РМАЗ_РВОС; переходим к дальнейшим действиям 
тее 

Т5ВеаЧуМА_3 епар 


Проверку готовности канала ОМА в С++ можно выполнить так, как пока- 
зано в листинге 13.4. 


истинг 13.4. Проверка готовности канала контроллера ОМА-1 в С++ 





рооЪ ТзКеаЧуПМА_1 { ип519пе@ 1п6 аСпаппе1) 
{ 
ОМОВО 4ЧмВе5\11%е = 0; 
1Е ( оСВапре1? > 3) гетагп; 
// получаем байт состояния 
1проге ( 0х08, &амВези1%, 1); // ОМА-1 
// проверяем указанный канал 
зи1ЕсВ ( аСБаппе1) 
{ 
сазе 0: 
1Е ( ( амВеза\ & 0х10) == 0х01) тгебагр $гае; 
Ьгеак; 
сазе 1: 
1Е ( ( амВези1% & 0х20) == 0х01) гебагр &гае; 
Ъгеак; 
сазе 2: 
1Е ( ( амВеза1е & 0х40) == 0х01) гебагп &тае; 
Ьтеак; 
сазе 3: 
1Е ( ( амВезоа1* & 0х80) == 0х01) тгебагр &гче; 
Ьтгеак; 
} 


тесаги Еа15е; 


494 Часть [. Работа с аппаратными ресурсами в И/пдоиз 


Вот и все, что мне хотелось рассказать о контроллере прямого доступа 
к памяти. Несомненно, его использование существенно увеличивает ско- 
рость обмена данными между устройством и компьютером, но следует пом- 
нить, что далеко не все современные устройства поддерживают такой режим 
работы. Кроме того, перед использованием контроллера необходимо убе- 
диться в том, что выбранный канал не занят другим устройством и готов 
к работе. 


ГЛАВА 14 


Контроллер прерываний 


Любой компьютер имеет в своем составе разнообразные внешние и внут- 
ренние устройства. Каждое из них так или иначе управляется центральным 
процессором, который в свою очередь должен успевать обрабатывать все 
поступающие данные. Поскольку процессор не может одновременно рабо- 
тать более чем с один устройством, пришлось придумывать какие-то спосо- 
бы для разделения обработки данных, поступающих от конкретных уст- 
ройств в отдельно взятой временной фазе. Вполне работоспособным пока- 
зал себя метод циклического опроса каждого устройства с последующей 
обработкой данных, однако в результате получилась система с очень низкой 
производительностью, поскольку болыная часть процессорного времени 
тратилась на банальное повторение одних и тех же операций (опрос, опо- 
знавание и последующий обмен данными). Наиболее приемлемым выходом 
из такой ситуации было бы использование процессора только тогда. когда 
он нужен определенному устройству. В результате решения этой задачи 
появилось новое устройство, называемое контроллером прерываний (на- 
пример, 8259 фирмы Пие). Общий принцип его работы достаточно прост: 
когда возникает необходимость в использовании процессора, каждое уст- 
ройство посылает сигнал запроса в контроллер прерываний. В контроллере 
полученный запрос "рассматривается" и, в зависимости от назначенного 
устройству приоритета, посылается на выполнение центральному процессо- 
ру. Процессор, получив запрос от контроллера прерываний, запоминает 
свое текущее состояние и переключается на выполнение запрошенной опе- 
рации, по выполнении которой возвращается к решению сохраненной зада- 
чи. Такой режим работы называется прерыванием и позволяет достаточно 
эффективно обслуживать все имеющиеся в системе устройства. 


Контроллер прерываний состоит из двух микросхем 8259 (в настоящее вре- 
мя они интегрируются в общий набор микросхем), подключенных по кас- 
кадной схеме. Каждая из них имеет 8 линий прерываний, закрепленных за 
определенным устройством. Первая микросхема обслуживает прерывания 
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от ВОО ДО 1ВО7, а вторая — от тво8 до 18015. Все прерывания имеют свой 
уровень приоритета обслуживания процессором. Самый высокий приоритет 
назначен прерыванию тво0, а самый низкий — тво15. В табл. 14.1 показано 
стандартное назначение каждого прерывания. В скобках после номера пре- 
рывания указан приоритет в числовом выражении. 


Таблица 14.1. Список аппаратных прерываний 


п нА я Назначенное устройство 
тВоо (0) Таймер 
тво (1) Клавиатура 
тво? Каскадное подключение второго контроллера 
твоз (10) Последовательный порт СОМ2 
тво (11) Последовательный порт СОМ1 
тво5 (12) Параллельный порт ЕРТ2 
твоб (13) Контроллер флоппи-дисководов 
тво7 (14) Параллельный порт ЕРТ1 
тво8 (2) Часы реального времени (СВТ) 
тво9 (3) Свободен 
твото (4) Контроллер видеоадаптера 
тво11 (5) Свободен 
18012 (6) Мышь Р$/2 
18013 (7) Математический сопроцессор 
тво14 (8) Первый контроллер жесткого диска 
тво15 (9) Второй контроллер жесткого диска 


Чтобы получить доступ к контроллеру прерываний, следует использовать 
следующие порты ввода-вывода: 20ъ, 21в, АО и АЛн. Порты 20ь и 215 обра- 
батывают прерывания тво0—тво7 для первого контроллера, а порты Абв и 
А1п — прерывания 1в08—18015 для второго контроллера прерываний. 


Для организации работы контроллера прерываний используются специаль- 
ные команды: управляющая команда инициализации (1С\/ — шша|тайоп 
СоттапЯ \Уога) и управляющая команда операции (ОСУ’ — ОрегаНоп 
Соттапа \ога). Существуют четыре команды инициализации (от | до 4): 
ТСи1, ТСИ2, ТСИЗ и тси4. Рассмотрим каждую из них подробнее. 
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14.1. Команда /СИ/1 


Это начальная команда инициализации контроллера прерываний. Для запи- 
си данной команды в регистры контроллеров (ведущего и ведомого) исполь- 
зуются соответственно порты 203 И АОЬВ. Формат команды тси1 представлен 
в табл. 14.2. 


Таблица 14.2. Формат команды тси1 






Описание 


Приведем краткое описание таблицы. 


С Бит 0 управляет использованием команды тси4. Если бит установлен в 1, 
команда будет вызвана. 


С Бит 1 определяет использование ведомого контроллера (1 — не использу- 
ется, @ — используется). 


С Бит 2 определяет размер вектора прерывания (1 — 4 байта, 0 — 8 бай- 
тов). 


О Бит 3 определяет режим срабатывания триггера (1 — по фронту, 0 — по 
уровню). 


СО Бит 4 должен быть установлен в 1. 
С Биты 5—7 должны быть установлены в 0. 


14.2. Команда /СИ/2 


Эта команда позволяет установить адрес вектора прерывания для тво0 или 
1808. Используются только биты с 3 по 7. Для первого контроллера нужно 
записать значение озн, а для второго — 70,3. 


14.3. Команда /СИ/З 


Команда имеет различное значение, в зависимости от типа контроллера. 
Для ведущего устройства используются биты 0—7. Если значение равно 1, 
значит, подключен ведомый контроллер. Для ведомого устройства исполь- 
зуются только биты 0—2. Они определяют номер выхода ведущего контрол- 
лера, к которому подключен ведомый, и могут принимать одно из следую- 
щих значений: 000ъ — выход 0, 0015 — выход 1, 0105— выход 2, 0116 — вы- 
ход 3, 1006 — выход 4, 1015 — выход 5, 1106 — выход 6 и 1115 — выход 7. 
Биты 3—7 должны быть установлены в 0. 


498 Часть |. Работа с аппаратными ресурсами в И/пдои$ 


14.4. Команда /СИ/4 


Эта команда позволяет настроить дополнительные режимы работы. Формат 
команды представлен в табл. 14.3. 


Таблица 14.3. Формат команды тси4 






Описание 


Приведем краткий комментарий к таблице. 


О Бит 0 определяет поддержку типа процессора (1 — 8086, 0 — 8085). 


О Бит 1, установленный в 1, означает, что используется режим автоматиче- 
ского заверщения прерывания Ест. 


С Биты 2—3 определяют режим работы: 00ь или 015 — для небуферизиро- 
ванного режима, 106 — буферизация для ведомого контроллера, 115 — 
буферизация для ведущего контроллера. 

С Бит 4 определяет специальный вложенный режим (1 — использовать, 
0 — не использовать). 


О Биты 5—7 зарезервированы и должны быть установлены в 0. 


Кроме команд инициализации, существуют также три команды управления: 
0Си1, ОСИ2 и 0СиЗ. Они позволяют изменять параметры работы уже инициа- 
лизированного контроллера прерываний. 


14.5. Команда ОСИ/1 


Команда управляет маскированием различных прерываний. Установка бита 
в | позволяет запретить соответствующее прерывание, а сброс бита в 0 раз- 
решает его. В табл. 14.4 показаны соотношения битов регистра и номеров 
прерываний для обоих контроллеров. 


п 14.4. Соотношения битов м и ми прерываний 


Е Тво6 ТВО5 ТВО4 ТВОЗ = ии 
18015 1ТВО14 18В013 18О12 18011 1ТВО10 ТВО9 
Прежде чем изменить значение маски прерываний, необходимо прочитать 


текущее значение из порта, а затем, установив нужный разряд с помощью 
операции ИЛИ, записать полученный результат обратно в порт. 









Порт 21. 





Порт Ав 
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14.6. Команда ОСИ/2 


Данная команда позволяет управлять использованием команды Еот (окон- 
чанием прерывания), а также изменяет приоритет выполнения конечной 
фазы прерывания. Формат команды представлен в табл. 14.5. Команда (сиг- 
нал) кот необходима контроллеру прерываний для завершения операции 
обработки прерывания и сброса внутренних регистров для последующего 
использования, поэтому практически всегда по окончании работы с преры- 
ванием необходимо записывать в регистр 20н (АбЪ) значение 20%. 


Таблица 14.5. Формат команды оси? 









Описание Использование кот Приоритет 





Приведем краткое описание таблицы. 


С Биты 0—2 определяют номер линии (тво), которая будет использована, 
если бит 6 установлен в 1. Возможны следующие значения: 0006 — выход 0, 
001ь — выход |, 0105 — выход 2, 0115 — выход 3, 1006 — выход 4, 1015 — 
выход 5, 1105 — выход би 1115 — выход 7. Биты 3—7 должны быть уста- 
новлены в 0. 


0 Биты 3—4 определяют код команды оси2 (005). Должны быть установле- 
ны в 0. 


П Биты 5—7 определяют вариант использования команды окончания пре- 
рывания (Ест). Возможны следующие значения: 


® 0005 — автоматический сдвиг приоритетов запрещен; 

» 1006 — автоматический сдвиг приоритетов разрешен; 

® 0015 — неспецифичная команда ЕОТ; 

® 011ь — специфичная команда ЕОТ; 

» 1015 — сдвиг приоритетов для неспецифичной команды Ест; 
® 111ь — сдвиг приоритетов для специфичной команды Еот; 

® 1105 — использование сдвига приоритетов; 


® 0105 — нет никаких операций. 


14.7. Команда ОСИ/З 


Команда позволяет прочитать текущее состояние контроллера прерываний. 
Формат команды представлен в табл. 14.6. 
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Таблица 14.6. Формат команды осиз 





Описание 


Приведем краткий комментарий к таблице. 


С Биты 0—1 позволяют установить режим доступа к состоянию контролле- 
ра. Возможны следующие значения: 006 и 01ь — не читать состояние, 
105 — читать регистр состояния на следующем прерывании, 116 — читать 
регистр состояния. 


С Бит 2 используется для метода поллинга (опроса). Если бит установлен 
в 1, режим поллинга используется. 


[№ 


Биты 3—4 определяют код команды оси2 (01ь). 


О Биты 5—6 определяют состояние специального режима маски (006 
И 015 — не использовать, 106 — выключить специальный режим маски, 
11ь — включить специальный режим маски). 


С Бит 7 зарезервирован и должен быть установлен в 0. 


Вот и вся необходимая теория. А теперь рассмотрим практические примеры 
программирования контроллера прерываний. Сначала напишем код для 
запрещения прерывания тво15 (второй контроллер Е) так, как показано в 
листинге 14.1. 


; сначала читаем порт А1В для получения маски прерываний 
хог АГ, АБ ; обнуляем регистр 

зп АБ, ОАОБ ; получаем текущее значение 

ог АБ, ВОВ ; запрещаем прерывание ТВО15 

онЕ ОАОВ, АЁЬ ; записываем обновленное значение в порт 


Аналогичный пример для С++ приведен в листинге 14.2. 


: Листинг 14.2. Запрещение прерывания 18915 в С++ 


// пишем функцию для запрещения прерывания от контроллера ТШЕ 
у014 21зар1етВО ТРЕ ( ипэлапея 1пе чтво) 
{ 

РМОВО ЧмВезиа1е = 0; 

1Е ( ( ство < 14) && ( отТВО > 15)) гебаги; 

1Е ( оТВО == 14) // первый контроллер 


Глава 14. Контроллер прерываний 501 


// получаем текущее значение 
1пРог® ( 0хАО, &амВезо1е, 1); 
АмВези1Е |= 0х40; // запрещаем ТВО14 
// записываем обновленное значение в порт 
оцЕРОГе ( 0хАО, АмВези1е, 1); 
} 
е15е // второй контроллер 
{ 
// получаем текущее значение 
1пРогё ( 0хАО, &АмВезо1е, 1); 
ЧиВези1е |= 0х80; // запрещаем 18015 
// записываем обновленное значение в порт 
ОЧЕРогЕ ( ОхАО, амВезо1е, 1); 


Между чтением и записью одноименного порта можно вставлять неболь- 
шую паузу. Попробуем запретить прерывания клавиатуры (листинг 14.3). 


Листинг 14.3. Запрещение прерывания тво1 дпя клавиатуры 





; сначала читаем порт 211 для получения маски прерываний 
хог АГ, АБ ; обнуляем регистр 

11 АБ, 21 ; получаем текущее значение 

ог АБ, 021 ; запрещаем прерывание ТВО1 

; добавляем маленькую задержку 

Зтр зроге $ +2 

ое 215, АБ ; записываем обновленное значение в порт 


Аналогичный пример для С++ приведен в листинге 14.4. 


Листинг 14.4. Запрещение прерывания тв01 в С++ 


// пишем функцию для управления прерыванием от клавиатуры 
уо1А О1заб1етвО Кюг ( Роо1 БЕпар1е) 
{ 
РИОВР АмВезо1е = 0; 
1Е ( БЕраб1е) // запретить прерывание 
{ 
// получаем текущее значение 
1пРоге ( 0х21, &амВезо1е, 1); 
ЧиВези1Е |= 0х02; // запрещаем ТВО1 
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5$1еер (1); // добавляем маленькую задержку 
// записываем обновленное значение в порт 
опЕРогЕ ( 0х21, амВезо1, 1); 

} 

е1зе // разрешить прерывание 

{ 
// получаем текущее значение 
1пРоге ( 0х21, &ЧмВезо1%, 1); 
ЯмвВези1е &= ОхЁРО; // разрешаем 1ВО1 
// записываем обновленное значение в порт 
оЧЕРОГЕ ( 0х21, ЧмВезо1%, 1); 


Вот и все, что может потребоваться в \!!т9о\/5 для программирования кон- 
троллера прерываний. 


ГЛАВА 15 


Процессор 


Думаю, нет смысла говорить о роли процессора в компьютерной системе. 
Эта небольшая по размерам микросхема является сердцем и мозгом компь- 
ютера и позволяет собрать в одно целое разнообразные типы устройств. 
В результате мы получаем мощный вычислительный комплекс, позволяю- 
щий решать не только и не столько научные задачи, но позволяющий нам 
окунуться в мир музыки или кино, игрушек и других всевозможных развле- 
чений. Правда, на работе иногда приходится возиться с текстовыми процес- 
сорами и бухгалтерскими программами, рисовать однообразные логотипы и 
обрабатывать базы данных, но главное, что компьютер дает нам уникальную 
возможность самообразования и выражения своих способностей. И все это, 
в первую очередь, благодаря небольшой микросхеме, установленной внутри 
корпуса и практически бесшумно (если выкинуть медный кулер) выпол- 
няющей свой тяжкий труд. 


Каждый программист должен иметь базовые сведения о центральном про- 
цессоре. К сожалению, прогресс так быстро создает новые и новые моди- 
фикации, что угнаться за всем просто невозможно. В этой главе мы рас- 
смотрим стандартные вопросы программирования СРО (Сетшхга! Ргосеззтв 
Упй — центральный процессор). 


Для получения информации о процессоре в языке АззетЫег существует 
специальная команда сРОТр. Она позволяет получить как версию процессо- 
ра, так и поддерживаемые им возможности. Данную команду можно ис- 
пользовать для процессоров ие! (80486), АМО (804860Х4) и Супх М1. 
Прежде чем начать работу с этой командой, следует убедиться, что ее мож- 
но использовать в данной системе. Для этого необходимо установить бит Ас 
в регистре ЕЕТАС$. Если операция пройдет успешно, значит, команда срРотр 
поддерживается. Пример кода для проверки команды срИТр представлен в 
листинге 15.1. Если команда сротр не поддерживается вашим компилято- 
ром, используйте вместо нее строку "аь охоЕ, 0хА?". 
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Листинг 15.1. Проверка поддержки процессором команды СРИТО 





развЕа ; сохраняем текущее значение регистра ЕЕТАС$ 
рор ЕАХ , ; получаем ЕЕЪАС$ 

пох ЕСХ, ЕАХ ; копируем 

хог ЕАХ, 400001; устанавливаем в 1 бит АС (для ТО 200001) 


ризВ ЕАХ ; новое значение регистра ЕЕТАС$ 

рорЕа ; заменяем текущее значение ЕЕЬАСЗ 

разрЕа ; сохраняем текущее значение регистра ЕЕЪАСЗ 
рор ЕАХ ; сохраняем ЕЕЬАС5 


хог ЕАХ, ЕСХ ; сравниваем 
3е № СРОТР ; процессор ниже 80486 


Кроме того, для проверки можно выполнить ту же последовательность дей- 
ствий, но для бита тр (21 бит в ЕЕТАС$). Аналогичный пример на С++ пред- 
ставлен в листинге 15.2. 





Листинг 15.2. Проверка поддержки процессором команды срИТЬ в С++ 
// макрос для замены команды СРОТО 
4АеЁ1пе СРОТР _аэм _еп1е ОхОР _азм еше 0хА2 
// пишем функцию проверки 
Боо1 ТзСРОТО () 
{ 
_ 11632 132Веза1е = 0; 
// блока кода на ассемблере 
_ азм 
{ 
разрЕа 
рор ЕАХ 
пох ЕСХ, ЕАХ 
хог ЕАХ, 400008; (для ТО 20000\) 
разв ЕАХ 
рорЕа 
разрЕа 
рор ЕАХ 
хог ЕАХ, ЕСХ 
)е ех1е_ргос 
пох 132Вези1%, 1 
ех1Е_ргос: 
} 
3Е ( 132Веза16) гебагп Егае; // СРОТР поддерживается 
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// СРОТР не поддерживается 
тееогп Еа15е; 


Теперь, когда мы убедились в поддержке команды срРотр, можно получить 
доступную информацию об установленном процессоре. Перед выполнением 
команды СРОТЬ в регистр ЕАХ следует записать определенное числовое значе- 
ние, от которого будет зависеть формат возврашаемых данных. Например, 
для процессоров Пе! формат данных показан в табл. 15.1. 


Таблица 15.1. Формат данных для процессора пе 


Значение регистра елх | Тип получаемой информации 


ов Регистр кАх; максимальное входное значение 
Регистр вх: 756Е6547н (*ипеС") 
Регистр ЕСх: 49656ЕбЭВ (еп!) 
Регистр Есх: есе57абЕн (Чет") 
018 Регистр ЕАх: версия (модель, тип, семейство) 
Регистр вх: зарезервирован 
Регистр сх: зарезервирован 
Регистр кох: информация о дополнительных свойствах 
02в Регистр ЕАХх: информация о встроенном кэше 
Регистр евх: информация о встроенном кэше 
Регистр ксх: информация о встроенном кэше 


Регистр Е_х: информация о встроенном кэше 


Приведем краткое описание таблины. 


С Если входное числовое значение равно 00т, в регистр ЕАХ записывается 
максимальное значение, которое может использоваться (в ЕАХ) с коман- 
ДОЙ СРОТЬ (в данном случае 2). Регистры Евх, ЕСХ и ЕБх содержат состав- 
ляющие имени производителя в АЗСП-кодах (12 символов), причем 
первое значение всегда расположено в младшем регистре (вт, сь и р). 
Для процессоров фирмы АМР используется строка "АзевепЕ1сАмМО", а для 
Супх — "СугахТазкеаа". 


О Если числовое значение равно 01ь, в регистр ЕАХ записывается информа- 
ция о версии процессора. Формат этого регистра показан в табл. 15.2. 
Регистры ЕВХ и ЕСХ зарезервированы и не используются. В регистр ЕБХ 
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записывается информация о дополнительных свойствах процессора. 
Формат этого регистра представлен в табл. 15.3. 


С Входное числовое значение 025 позволяет получить информацию о кэ- 
шах. В табл. 15.4 перечислены некоторые значения для определения раз- 
мера внутреннего кэша процессора. При этом в регистр ЕАХ записывается 
количество вызовов СРОТЬ (026), необходимое для получения всей ин- 
формации. 


Таблица 15.2. Формат регистра с версией СРИУ 





и в [из | [а 
Описание РатйуЮ | Модейр | зеррта 0 


Приведем некоторые пояснения к табл. 15.2. 


С Биты 3—0 определяют модификацию процессора. Для ие] это значение 
будет больше 3, если установленный процессор выше 80486. 


С Биты 7—4 определяют модель процессора. Значение этого поля зависит 
от соседнего поля ГатЦу ПО и применяется совместно с ним, чтобы 
идентифицировать тип установленного процессора. Известные мне ком- 
бинации значений для. процессоров Пе] перечислены далее в табл. 15.5. 


П Биты 11—8 определяют номер семейства процессора. 


С Биты 13—12 для старых процессоров указывают один из следующих ти- 
пов: 005 — ОЕМ, о1ь — Оуеганпуе, 106 — Оча|. 


О Биты 31—14 зарезервированы и не используются (должны быть равны 0). 


Таблица 15.3. Формат регистра свойств процессора 


Бит Обозначение Описание 


0 ЕРУ Наличие математического сопроцессора 

1 УМЕ Поддержка виртуального режима \/86 

2 ОЕ Поддержка точки останова для отладчика 

З РЗЕ Поддержка расширенных размеров страниц (до 4 Мбайт) 
4 Т$С Поддержка команды ВОТ$С и СР4 

5 М$В Поддержка команд ВОМ$ВН и \УВМ$В 

6 РАЕ Поддержка расширенных адресов (более 32 бит) 

7 МСЕ Поддержка проверки машинных ошибок 

8 СХ8 Поддержка команды СМРХСНС8В 
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Бит 
9 
10 
11 


12 
13 
14 
15 
16 


17 


18—22 


23 
24 


25—31 


Обозначение 


АРС 
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Таблица 15.3 (окончание) 


Описание 
Поддержка встроенного контроллера прерываний АР!С 
Резерв 


Поддержка быстрых системных вызовов (команды 
ЗУЗЕМТЕВ И ЗУЗЕХТТ) 


Поддержка регистров диапазона памяти МТВН 
Поддержка РОЕ в СА4 

Поддержка проверки машинной архитектуры 
Поддержка расширенных команд СМОМ 


Поддержка таблицы атрибутов, позволяющей увеличить 
адресуемую память 


Поддержка 36-разрядных расширенных страниц (страни- 
цы размером 4 Мбайт позволяют использовать физиче- 
скую адресацию памяти свыше 4 Гбайт) 


Резерв 
Поддержка технологии ММХ 


Поддержка быстрых команд для чисел с плавающей точ- 
кой (ЕХЗАУЕ И ЕХВЗТОВ) 


Зарезервированы и должны быть равны 0 


Таблица 15.4. Значения второго кэша процессора 


Размер кэша, Кбайт 
Кэш отсутствует 
128 
256 
512 
1024 
2048 
128 
512 
1024 
2048 
256 
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Таблица 15.4 (окончание) 


Размер кэша, Кбайт 


512 
1024 
2048 


Таблица 15.5. Возможные значения для полей Еатйу 10 и Моде! 10 (те!) 


РатйЙу 10 | Мо4де!!О | Тип процессора 


00005 
00015 
00105 


00115 


01005 


01015 





8086/8088 
80186/80188 

80286 

761386 ОХ 

1 {е!386 $5Х (СХ, ЕХ) 
71386 $Ё 
Неизвестный тип 
пе1486 ОХ 

ме486 ОХ 

ем 86 $Х 

“ем 87 УХ (е\м86 ОХ) 
м{ем86 $2 

1е15Х2 

ме0Х2 

ме10х4 
Неизвестный тип 
Репнит 

Репйит Р54С 


Репёит оуегапуе 


\е0Х4 разогнанный до Репёит 


пе! Репвит ММХ 
\е! Репбит (Мое) 
не! Репёит ММХ (Мое) 


Неизвестный тип 
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Таблица 15.5 (окончание) 


Ратйу 10 


Моде! !О | Тип процессора 





01105 име! Репвит Рго 
ие! РепНит Рго 
име! Репбит || 
|4! Сеегоп (если кэш 2 равен ох40 или 0х41) 
ие] Репнит 1! (если кэш 2 равен 0х43) 
ме! Репбит || Хеоп (если кэш 2 равен 0х44 или 0х45} 
не! Сеегоп А (если кэш 2 равен 0х40 или 0х41) 
уе! Репвит || (если кэш 2 равен 0х42 или 0х43) 
ме! Сеегоп Мое (если кэш 2 равен ох41 и Зерртд 10 = 10) 
и\е! Репбит || Мое (если кэш 2 равен 0х42 или 0х82 
и Зерриа 10 = 10) 
не! Репбит Ш (если кэш 2 не равен 0х44 и 0х45} 
ие! Репвит Ш Хеоп (если кэш 2 равен 0х44 или 0х45) 
ме] Репйит 1! Е Соррегтте (если кэш 2 не равен ох41) 
ие] Сеегоп 2 (если кэш 2 равен 0х41) 
ие! РепНит |! Хеоп 
Неизвестный тип 
11115 ие! Репёит 4 


Рассмотрим пример получения информации о процессоре (листинг 15.3). 


Листинг 15.3. Получение стандартной информации о СРУ 





Уепаог_ Маше @ 12 апр (?); информация о производителе 
Зкерр1па_ТР аЮ ?; значение 5&ерр1л9 тр 

Моае1 ТР 4 ? ; Значение Моае]1 тр 

Еат11у ТР чаю ? ; значение Рат11у ТО 

Ееасаге_СРО аа ?; свойства процессора 

СаспесрРО аа 4 апр (?) 
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; общий код программы 

хог ЕАХ, ЕАХ ; устанавливаем ЕАХ в 0 

срила ; вызываем команду СРОТР или заменяем на Ф ОхОЕ, 0хА2 
; сохраняем полученные данные 

поу Чмога рег Уепаог Маше, ЕВХ 

по\у Чмога рег Уепаог Маме{+ 4], ЕБХ 

по\у Чмога рег Уепаог Маме{+ 8], ЕСХ 

; получаем данные о свойствах и версии 

хог ЕАХ, ЕАХ ; устанавливаем ЕАХ в 0 

1пс ЕАХ ; определяем значение 1 

сра1а ; вызываем команду СРОТР или заменяем на 9Ю ОхОЕ, 0хА2 
поу 5терр1па_Тр, АГ; копируем первый байт регистра ЕАХ 

ап Зтерр1па_Тр, ОРБ; выделяем значение 5серр1та ТО 

апа АЪ, ОРОР ; восстанавливаем значение регистра 





зрг АГ, 4 ; сдвигаем на 4 разряда вправо 
поу Мо4е1 Тр, АГ; получаем значение Моде1 Тр 
апа ЕАХ, ОЕРОВ; выделяем биты 8-11 

$Рг ЕАХ, 8 ; сдвигаем на 8 разрядов вправо 
апЯ ЕАХ, ОР ; выделяем значение Кам11у ТР 

; получаем дополнительные свойства процессора 
шоу ЕГеабаге_ СРО, ЕСХ 

; получаем размер встроенного кэша 

хог ЕАХ, ЕАХ ; устанавливаем ЕАХ в 0 

пох ЕАХ, 026 ; определяем значение 028 

сра1а ; вызываем команду СРОТР или заменяем на 9Ю ОхОЕ, 0хА2 
пох Чмога рег [СасВесРО + 0], ЕАХ 

пох амога рёг {СасБесРО + 4], ЕВХ 

пох Чиога рук [СасьесРИО + 8], ЕСХ 

поу ЧмогЯ рег [СасбеСсРО + 12], ЕРХ 


Аналогичный пример на С++ представлен в листинге 15.4. - 





// макрос для замены команды СРОТР 
#АеЁ1пе СРОГР _азш _еп12 ОхОЕ аз _ет1е ОхА2 
// пишем функцию для получения стандартных сведений о процессоре 
у01А СессРИ_ТпЕо {) 
{ 
ВУТЕ Уепдог Маме [13]; 
ВУТЕ 5серр1та_ ТО; 
ВУТЕ Модет тр; 
ВУТЕ Рап11у ТО; 
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ОМОВО Ееабаге_ СРО; 
ОМОВР СаспесрРО[4}; 
ип319пеа 1пс оСаспе 1 = 0, аСасвВе_2 = 0; 
// получаем информацию о процессоре 
__азм 
{ 
хог ЕАХ, ЕАХ; устанавливаем ЕАХ в 0 
сро1а; вызываем команду СРОТР 
; сохраняем полученные данные 
поту @мога рег Уепаог Мате, ЕВХ 
пох Чмога рег Уепаог Маме{+ 4], ЕБХ 
поу Чмога рег Уепаог_Маще[+ 8], ЕСХ 
; получаем данные о свойствах и версии 
хог ЕАХ, ЕАХ; устанавливаем ЁАХ в 0 
1пс ЕАХ; определяем значение 1 
сру1Я; вызываем команду СРОТР 
поУ 5серр1п9_ТО, АБ; копируем первый байт регистра ЕАХ 
ап $терр1п9_Тр, ОЕВЬ; выделяем значение З(ерр1тпа ТО 
апа АГ, ОРОР; восстанавливаем значение регистра 
зРк АТ, 4; сдвигаем на 4 разряда вправо 
поу Мо4е1_ТРр, АТ; получаем значение Мо4е1 Тр 
апа ЕАХ, ОКРОВ; выделяем биты 8-11 
эр: ЕАХ, 8; сдвигаем на 8 разрядов вправо 
ап ЕАХ, ОЁРИ; выделяем значение Гат11у_ ТР 
; получаем дополнительные свойства процессора 
поу Геабаге_СРИ, ЕСХ 
; получаем размер встроенного кэша 
хог ЕАХ, ЕАХ; устанавливаем ЕАХ в 0 
поу ЕАХ, 028; определяем значение 026 
сри1а; вызываем команду СРОТО 
поУу Чмога ртг [СасБесРИО + 0], ЕАХ 
поу @Чмога рёг [СасвесрИО + 4], ЕВХ 
поу @Чмога рег [СасВесрО + 8], ЕСХ 
поу амога рег [СасьесрИ + 12], ЕБХ 


// обрабатываем значение кэша для Тпсе1 
ОМОВР сасБеТетр = СасьесрРО {3]; 


ВУТЕ сасье 11 = ( ВУТЕ) ( сасреТетр >> 8); // размер первого кэша 
ВУТЕ сасБе Тир = ( ВУТЕ) ( сасвеТетр >> 24); 

ВУТЕ саске _Т2 = ( ВУТЕ) ( саспеТетр >> 0); // размер второго кэша 
// получаем размер первого кэша 

1Е { ( сасве Тир == 0х0А) && ( саспе 11 == 0х0б} ) 


иСасНе_1 = 16; // 16 Кб 
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е15е 1ЕЁ { ( сасВе Тир == 0х0С) && ( сасне 11 == 0х08)) 
Сасве 1 = 32; // 32 кб 
// получаем размер второго кзша 
эи1сср ( сасре 12) 
( 
сазе 0х40: // нет второго кэша 
ргеак; 
сазе 0х41: // 128 Кб 
сазе 0х79: 
уСасве_2 = 128; 
Ьгеак; 
сазе 0х42: // 256 Кб 
сазе 0х82: 
иСасве_2 = 256; 
Ьгеак; 
сазе 0х43: // 512 Кб 
сазе 0х7А: 
сазе 0х83: 
уСасВе_2 = 512; 
Ьгеак; 
сазе 0х44;: // 1024 кб 
сазе Ох7В: 
сазе 0х84: 
СасНе_2 = 1024; 
Ьгеак; 
сазе 0х45: // 2048 Кб 
сазе 0х7С: 
сазе 0х85: 
9СасНе_2 = 2048; 
Ьгеак; 


Кроме стандартных аргументов, процессор может поддерживать расширен- 
ные значения для команды сритр, перечисленные в табл. 15.6. Эти значения 
следует использовать для получения данных о совместимых с Пе! процес- 
соров АМРВ и Супх. 


Таблица 15.6. Расширенные значения для команды срРИиТр 


Код Описание 


озв Позволяет получить серийный номер процессора 
(начиная с 1\е! Репфит !!!), закодированный в регистрах ЕСХ и ЕБХ 
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Таблица 15.6 (окончание) 


Код Описание 


80000000. — Максимальное расширенное значение, поддерживаемое процессором 
800000015 — Возвращает версию и свойства для процессора 

800000025 — Название процессора 

800000035 — Название процессора 

800000045 — Название процессора 

800000055 — Возвращает информацию о размерах первого кэша 


80000006» — Возвращает информацию о размерах второго кэша 





В листинге 15.5 приводится пример использования расширенного значения 
команды сритр для получения серийного номера процессора. 


; выделяем переменную для хранения серийного номера 
Тоёе1 5ег1а1М№алтрег Ча 3 а%р (0) 

; общий код программы 

хог ЕАХ, ЕАХ ; обнуляем регистр 

срила ; вызываем команду СРОТО 

поу Чмога рЕг [Тпёе1 бег1а1Мапфег + 0], ЕАХ 

шоу ЕАХ, ОЗВ ; получить номер СРО 

срула ; вызываем команду СРОТО или заменяем на 9Ю ОхОЕ, 0хА2 
; получаем серийный номер 

поу Амога рег [Тпёе1 5ег1а1М№атфег + 4], ЕОХ 

‚ноу Амога рег [Тпёе1 Зег1а1Матбег + 8], ЕСХ 


Аналогичный пример на С++ представлен в листинге 15.6. 


// макрос для замены команды СРОТО 

#$АаеЁ1пе СРОТР _азш _ет1е ОхОГг азм _ет1е 0хА2 

// выделяем переменную для хранения серийного номера 
ОМОВР ЧмЗег1а1М№опфехк [3]; 

// пишем функцию 

уо1а Сеё8М Тпее1 () 

{ 


аз 
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хог ЕАХ, ЕАХ; обнуляем регистр 

сри1а; вызываем команду СРОТО 

пох Амога рег [Чмбег1а1Мапрег + 0], ЕАХ 
пох ЕАХ, ОЗР; получить номер СРИ 

сра1а; вызываем команду СРОТО 

; получаем серийный номер 

пох Амога рег [ЧамЗег1а1Мапрег + 4], ЕПБХ 
поу Чмога рег [9иЗег1а1Матрек + 8], ЕСХ 


} 

// сохраняем серийный номер в строку 

сВаг $25ег1а1[30]; 

зрг1ипсЕ {( $25ег1а1], "Тпсе] 5ех1а1 М№аифег: %081х-%081х-%081х", 
аибег1а1Магрег [0], ЧмЗег1а1Моиюек [1], ЯмЗег1а1 Марек [2]); 


И еше попробуем получить название процессора, используя расширенные 
значения команды сротрЬ (листинг 15.7). 





; выделяем переменную для хранения имени процессора 
СРИ_Маше 9Ф 48 апр (0) 
; общий код программы 


хог ЕАХ, ЕАХ ; обнуляем регистр 
оу ЕАХ, 800000025 
сри1а ; вызываем команду СРОТО или заменяем на @Ю ОхОЕ, 0хА2 
шоу Амога рег [СРО Маше + 0], ЕАХ 
пох Чмога рёг [СРИ Маше + 4], ЕВХ 
пох Чмога рег [СРУ Маше + 8], ЕСХ 
поу Яиога рег [СРО Маме + 12], ЕБХ 
шоу ЕАХ, 800000035 
сриза ; вызываем команду СРОТО или заменяем на ЧЮ ОхОЕ, 0хА2 
пох нога рег [СРУ Маше + 16], ЕАХ 
шоу Ямога рег [СРО Маше + 20], ЕВХ 
пох Чмога рег [СРО Маше + 24], ЕСХ 
поу Чиога рег [СРО Маше + 28], ЕШБХ 
поу ЕАХ, 800000048 
срула ; вызываем команду СРОТО или заменяем на ЧФ ОхОЕ, 0хА2 
поу Чиога рег [СРО Маше + 32], ВАХ 
поу @Чмога рег [СРО Маше + 36], ЕВХ 
[СРО Маме + 40], ЕСХ 
[ + 44], ЕБХ 


поу ЧмогЯ рёг 


шоу Чмока рег [СРУ_Маще 
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Аналогичный пример на С++ представлен в листинге 15.8. 





: Листинг 15.8. Получение названия установленного процессора в С++ 


О 


// макрос для замены команды СРОТО 

АеЁ1пе СРОТО _азм _ет1е ОхОГг _азм _ет1е 0хА2 

// выделяем переменную для хранения серийного номера 
сВаг $2СРИ_ Маше [49]; 

52СРУ_Маще[48] = 0; // завершающий ноль 

// пишем функцию 

у01А бееСРО Маме () 


ази 


хог ЕАХ, ЕАХ; обнуляем регистр 

поу ЕАХ, 800000025 

сра1а; вызываем команду СРОТО 

шоу Чмога рёг [СРО Маме + 0], ЕАХ 

поу Чмога рёг [СРО Маше + 4], ЕВХ 

шоу Чмога рёг [СРУ Маме + 8], ЕСХ 

оу Чмога рёг [СРО Маше + 12], ЕОХ 
оу ЕАХ, 800000035 

сру1А; вызываем команду СРОТО 

шоу Амога рег [СРО Маше + 16], БАХ 
поу Чмога рёг [СРУ Маме + 20], ЕВХ 
шоу Чмога рёг [СРУ Маше + 24], ЕСХ 
шоу ЧмогА рег [СРО Маше + 28], ЕШХ 
поу ЕАХ, 800000046 

сро1Я; вызываем команду СРОТО 

оу Чмога рег [СРЧ Маше + 32], ЕАХ 
оу Чмога рёг [СРО Маме + 36], ЕВХ 
шоу Чмога рёг [СРО Маме + 40], ЕСХ 
оу Чмога рег [СРУ Маме + 44], ЕБХ 


Вот и все, что мне хотелось рассказать о программировании процессора. 


ГЛАВА 16 


Аппаратный мониторинг 
системы 


В конце 90-х годов производители материнских плат стали активно исполь- 
зовать различные датчики температуры, питания и управления вентилято- 
рами, благодаря чему появилась возможность контролировать критические 
компоненты системы в реальном времени. В настройки ВЮ5$ были добав- 
лены дополнительные возможности мониторинга напряжений блока пита- 
ния, температуры центрального процессора и внутреннего пространства 
корпуса, а также вывода информации о текущем состоянии вентиляторов 
(до трех). Важность этого трудно переоценить. Кроме контроля за состояни- 
ем системы, пользователь может самостоятельно устанавливать ограничения 
на температуру или питающие напряжения, что при умелом использовании 
помогает в ранней диагностике аппаратных сбоев оборудования. Например, 
установив максимальное значение температуры разогрева для процессора, 
можно защитить его от перегревания и возможного выхода из строя (это 
особенно актуально для процессоров фирмы АМО). Контроль за вентилято- 
ром процессора позволяет вовремя выключить компьютер, если вентилятор 
вдруг заклинил или вовсе сгорел. А продвинутые пользователи, например, 
знают, что импульсный блок питания имеет довольно короткий срок экс- 
плуатации (примерно 5 лет) и требует особого внимания. Необходимо по- 
стоянно (хотя бы раз в месяц) проверять значения питающих напряжений и 
при отклонении последних более чем на 10 % в ту или иную сторону сразу 
же заменять блок питания целиком. Как правило, ремонту импульсные бло- 
ки питания не подлежат (не верьте никому, кто уверяет вас в обратном), и 
несоблюдение этих правил может привести к выходу из строя всех (!) ком- 
понентов системы. Но даже потеря "железа" не так важна, как потеря ин- 
формации, хранящейся на компьютере. 


Из всего сказанного следует, что программист должен знать и уметь рабо- 
тать с перечисленными выше возможностями для повьниения не только 
безопасности компьютерной системы, но и своего профессионального мас- 
терства. 
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В этой главе мы поговорим о том, как в современных компьютерах реализу- 
ется аппаратный мониторинг оборудования. 
* * * 


Для поддержки мониторинга системы на материнскую плату добавляют са- 
мостоятельный модуль (микросхему) управления, позволяющий эффективно 
отслеживать напряжения питания, обороты вентиляторов и температуру. 
Существуют различные модули контроля оборудования, выпускаемые веду- 
щими производителями, но здесь мы рассмотрим наиболее популярные 
микросхемы фирмы МаНопа! Зеписопаисог. Изучив использование чипов 
данной фирмы, вы без особого труда сможете разобраться с остальными. 


Итак, имеется несколько основных микросхем аппаратного мониторинга 
системы: 1М78, 1.М79 и 1М80. Они практически идентичны, различаются 
в основном диапазоном и точностью измеряемых параметров. Мы рассмот- 
рим только вторую и третью микросхемы, поскольку М78 практически не 
отличается от Е М79. Основные характеристики этих микросхем представле- 
ны в табл. 16.1. 


Таблица 16.1. Основные характеристики микросхем ЁМ79 и ЁМ80 






Поддерживаемое значение 














Описание параметра 
Ем80 


Напряжение питания 5В 2,8—5,75 В 
Потребляемый ток (работа-—простой) 1—10 мкА 0,2—15 мкА 
Разрядность АЦП 8 бит 8 бит 
Максимальная погрешность +1% +1% 


измерения напряжения 





Погрешность 
измерения температуры 


Для диапазона 
от -10 до +100 °С 
равна +3 °С 


Для диапазона 
от-25 до +125 °С 
равна +3 °С 


0,5 °С 






Точность измерения температуры 





Микросхема 1М79 работает с шинами [$А и 5епа! Виз и поддерживает сле- 
дующие возможности: 


О контроль температуры; 
С управление тремя вентиляторами; 
О пять положительных входных напряжений; 


[Г] два отрицательных входных напряжения, 





С проверка на сравнение получаемых значений; 
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О дополнительный температурный датчик (например, 1М75 или Е М99); 
О контроль вскрытия системного блока или изъятия какого-либо модуля. 


Данная микросхема считывает обороты для первого и второго вентилятора 
в диапазоне от |1 100 до 8 800 оборотов в минуту, а для третьего фиксирует 
только среднее значение 4 400. 


Микросхема ЕМ80 работает только с шиной $епа! Виз и поддерживает та- 
кие же возможности, как и предыдущая. 


Чтобы получить доступ к микросхеме мониторинга можно использовать 
порт 2901. Однако на несовместимой с Ни! платформе номер порта может 
быть другим (за информацией следует обратиться на сайт производителя 
материнской платы). 


Есть еще один нюанс, о котором следует знать. Официально в документа- 
ции ре! указан порт номер 80ъ, хотя реально работает 290,. Для определе- 
ния порта шины $ема! Виз (если стоит микросхема, отличная от ЕМ78 и 
ЕМ79) необходимо применить процедуру поиска на шине РС] (см. гл. 10) 
или попытаться обратиться через порты 90в (базовый регистр адреса) и 02ь 
(управляющий регистр). 


Микросхемы мониторинга используют для управления и настройки опреде- 
ленные внутренние регистры, представленные в табл. 16.2. В скобках указа- 
ны адреса регистров для микросхемы [М80. 


Таблица 16.2. Внутренние регистры управления 





















Адрес Значение 
нда а по Название Описание 
ре р умолчанию 
дов (00н) 000010005 Регистр Позволяет настроить параметры 
конфигурации | работы 
41а (018) 00000000 Регистр Отслеживают превышения допусти- 








мых заданных пределов или события 
прерываний (после чтения первого 
регистра будет автоматически выбран 
второй) 


состояния 1 






000000005 





Регистр 
состояния 2 


428 (02, 
















000000005 Регистр маски 1 | Позволяют маскировать различные 
(МО источники прерываний (после чтения 
первого регистра будет автоматиче- 


43 (зв) 












4ав (04в) 00000000ю | Регистр маски 2 | ски выбран второй). Регистры ЗМ! 
($М (Зу\ет Мападетег{ И\еггир управ- 
458 (—) 000000005 Регистр маски 1 ляют системными прерываниями, 
(ММО а регистры ММ! (М№оп-Мазкаые 
\еггир) — немаскируемыми 
46ъ (-) 010000006 | Регистр маски 2 | прерываниями 






(ММ9 
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Таблица 16.2 (окончание) 








Адрес Значение 
ее а по Название Описание 
р ТР умолчанию 






47в (055) 0101ххххь Регистр Позволяет читать значение делителя 


(00010100) делителя для установки оборотов первого 

и второго вентиляторов (младшие 

4 бита хранят состояние делителя, а 
старшие 4 бита позволяют установить 
новое значение). Для [1 М80 хранит 
одно значение делителя, равное 2 

(4 400) 


4вв (—) 0010110165 Регистр адреса | Содержит адрес шины Зепа! Виз 
шины Зепа! Виз | (по умолчанию 258) и может быть 
изменен 
498 (—) 11000005 Регистр сброса | Позволяет выполнить сброс микро- 
схемы, установив для регистров 
значения по умолчанию 


— (о6в) Регистр Управляет представлением значений 
температуры температуры (если бит 3 равен 1, то 
используется 12-разрядное представ- 
ление температуры и 4 младших бита 
значения расположены в битах 4—7) 
208-—ЗЕН Регистры Позволяют получить или установить 
данных все поддерживаемые параметры 


После подачи питания на микросхемы начинает работать непрерывный 
цикл измерения параметров системы с частотой один раз в секунду. Если 
микросхема содержит настройки для предельно-допустимых ограничений, 
происходит сравнение полученных и заданных значений. Если полученное 
значение превышает заданное, микросхема устанавливает сигнал прерыва- 
ния в соответствующий регистр состояния. С помощью регистров маски 
устанавливается генерация тех или иных прерываний во время мониторинга 
оборудования, а регистр конфигурации позволяет заблокировать те или 
иные прерывания. 





Поскольку микросхема ЕМ79 поддерживает шину ЗА, имеются также че- 
тыре внешних регистра, необходимые для управления всеми внутренними 
регистрами М79 (табл. 16.3). 


Работа с 1.М79 для ТЗА организуется следующим образом: 
1. В регистр х5ь записывается номер внутреннего регистра (см. табл. 16.2). 


2. После этого можно читать или писать данные в регистр хёв. 
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Таблица 16.3. Внешние регистры управления для Е М79 


Адрес Описание 


хов Самотестирование микросхемы 
ХАВ Самотестирование микросхемы 
х5В Регистр адреса для выбора внутреннего регистра (чтение и запись) 


хбВ Регистр данных (чтение и запись) 


Если на компьютере присутствуют обе шины (ЗА и Зена! Виз), следует 
в начале работы прочитать регистр х5в. Если бит 7 равен 0, можно работать 
с шиной ЗА, иначе используется шина Зепа! Виз. Переход на шину 13А 
требует примерно 10 мкс времени, а обратно — всего 1 мкс. Бит 7 можно 
только читать. 


Работа с 1.М79 для Зепа! Виз организуется следующим образом: 
1. В регистр хэв записывается адрес шины Зена! Виз (481). 


2. В этот же регистр’пишется номер внутреннего регистра микросхемы 
(см. табл. 16.2). 


3. В этот же регистр пишется байт данных. 
Чтение данных происходит так: 


1. В регистр хэн записывается адрес шины Зена! Виз (485). Этот пункт 
можно пропустить, если порт уже был выбран предыдущей операцией. 


2. Из этого же регистра читается номер внутреннего регистра микросхемы 
(см. табл. 16.2). 


3. Из этого же регистра читается байт данных. 


Как уже говорилось ранее, адрес регистра для шины Зена! Виз можно изме- 
нить, записав новое значение во внутренний регистр 48в. 


Регистр конфигурации (405) управляет сбросом устройства и блокированием 
прерываний. Установка бита 0 в 0 позволяет выполнить сброс микросхемы 
и перевести ее в энергосберегающий режим. Установка бита | в | выполня- 
ет инициализацию регистра. Бит 2 управляет блокировкой немаскируемых 
прерываний (1 — разрешить ММП. Бит 3 управляет работой микросхемы 
(0 — включить мониторинг оборудования). При начале опроса параметров 
бит 3 устанавливается в 0, а бит 0 — в 1. Опрос параметров ведется в сле- 
дующем порядке: температура, положительные напряжения питания (линии 
от 0 до 4), отрицательные напряжения питания (линии 5 и 6), первый, вто- 
рой и третий вентиляторы. Из-за задержки в работе микросхемы при чте- 
нии каждого последующего параметра следует делать паузу не менее 120 мс. 
Если за один раз вы читаете все параметры, перед следующей операцией 
чтения необходимо выполнить паузу не менее 1,5 сек. 
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Для управления вентиляторами используется внутренний генератор (22,5 кГц 
для выдачи сигнала за время одного полного оборота) и 8-разрядный счет- 
чик (максимум 255 отсчетов), определяющий количество сигналов. Напри- 
мер, если значение счетчика равно 153, обороты вентилятора равны 4 400. 
Управление оборотами сводится к установке значения делителя (1, 2, 4 и 8) 
в регистре делителя (47в). Это будет работать только для первого и второго 
вентиляторов. Третий вентилятор имеет постоянные значения: делитель ра- 
вен 2, а обороты — 4 400. По умолчанию начальные значения делителя и 
числа оборотов равны 2 и 4 400 соответственно. Для подсчета текущего зна- 
чения счетчика используется следующая формула: 


значение счетчика = (1,35 * 106) / (число оборотов * делитель). 


Значения температуры кодируются 8-битным значением (М79), где млад- 
ший бит определяет | °С. В табл. 16.4 представлены стандартные значения 
регистра температуры. 


Таблица 16.4. Стандартные значения 
для 8-разрядного представления температуры 








Значение регистра Температура, °С 
011111015 (708) +125 
00011001 (19) +25 
0000000ль (011) +1,0 
000000005 (001) +0. 
11111111ъ (ЕЕВ) —1 
111001115 (Е7в) —25 
11001001ъ (с9н) —55 





Если температура выше или ниже заданной, генерируется прерывание, и 
оно остается активным, пока не будет прочитан регистр состояния 1 (415). 


В микросхеме 1М80 значения температуры могут кодироваться дополни- 
тельно 9- (табл. 16.5) и 12-разрядным (табл. 16.6) двоичным значением, что 
позволяет повысить точность измерений. Для 9-разрядного представления 
температуры значение младшего бита равно 0,5 °С, а для 12-разрядного — 
0,0625 °С. 


Младшие 8 бит значения (для 12-битного представления) температуры 
можно прочитать из внутреннего регистра 285. Остаток будет записан в ре- 
гистр обн (биты 4—7). При 9-битном значении бит 9 будет записан в бит 7 
регистра температуры. 
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Таблица 16.5. Стандартные значения 
для 9-разрядного представления температуры 


Значение регистра Температура, °С 
0111110106 (ЕАН) +125 
000110010 (321) +25 
000000011 (038) +1,5 
00000000 (008) +0 

11111111125 (1ЕЕБ) —0,5 
1110011106 (1СЕВ) —25 
1100100105 (1925) —55 


Таблица 16.6. Стандартные значения 
для 12-разрядного представления температуры 


Значение регистра Температура, °С 
0111110000005 (7608) +125 
0001100100006 (1908) +25 
0000000100005 (0105) +1,0 
0000000000015 (018) +0,0625 
00000000 (001) +0 
1111111111115 (ЕЕЕВ) —0,0625 
111111110000 (ЕРОВ) —1,0 
111001110000 (Е70в) —25 
1100100100006 (сэон) —55 


И последнее, что мы рассмотрим здесь, — это структура внешних и некото- 
рых внутренних регистров управления. В табл. 16.7 и 16.8 показаны форма- 
ты регистров х5в и хб6н для ЕМ79. 


В табл. 16.9 показан формат регистр выбора адреса для 1.М80. 


В табл. 16.10 показан формат регистров конфигурации дяя [.М79 и 1.М80. 
Они позволяют инициализировать устройство мониторинга и установить 
режим работы. Кроме того, прочитав значение регистра после инициализа- 
ции (оно должно быть равно о8н), можно сделать вывод о наличии микро- 
схемы мониторинга на данной системе. 
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Таблица 16.7. Формат адресного регистра х5в для ЁМ79 


Доступ 


Запись 


Описание 


Содержит адрес внутреннего регистра (см. табл. 16.2) 


7 


и чтение 


Только чтение 


Определяет готовность устройства (если бит равен 1, 
можно записывать данные в регистр хбь для шины Зейа! 
Виз, иначе следует писать или читать регистр хёп после 


завершения работы на шине Зепа! Виз) 


Таблица 16.8. Формат адресного регистра хбр для [Е М79 


Биты 


0—7 


Доступ 


Запись 


Описание 


Данные, которые надо передать или получить 


и чтение 


Таблица 16.9. Формат адресного регистра для [М80 


Биты 


Доступ 


Запись 
и чтение 


Описание 


Содержит адрес внутреннего регистра (см. табл. 16.2) 


ОТ 00Н ДО 0бН И ОТ 208 ДО ЗЕВ 


Таблица 16.10. Формат регистра конфигурации для [М79 и 1М80 


Биты 


Доступ 


Запись и чтение 


Описание 


Управление запуском мониторинга системы (1 — вклю- 


чояа > 


Запись и чтение 


Запись и чтение 


Запись и чтение 


Запись и чтение 
Запись и чтение 
Запись и чтение 


Запись и чтение 


чить контроль, 0 — перевести в дежурный режим). Перед 
установкой бита в 1 следует записать желаемые пара- 
метры в регистры данных 20—ЗЕ® 


Установка бита в 1 позволяет включить прерывания 
(для [М79 ЗМЕпрерывания) 


Выбор активной выходной линии для 1М80 и включение 
прерывание ММ! для [М79 


Блокировка прерывания ЗМ! и ММ! для 1М79 и!В@ 
для [М80 (1 — блокировать, 0 — разрешить) 


Сброс устройства 
Выбор ММ!-прерываний (1 — ММЕ 0 — ВО) 
Управление питанием 


Восстановление питания на шине и инициализирует 
устройство 
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В табл. 16.11 и 16.12 показан формат первых регистров состояния (41 или 
015) для [.М79 и 1.М80. Регистры состояния позволяют отслеживать изме- 
нение значений на заданных линиях. 





Биты 











Биты 





Таблица 16.11. Формат первого регистра состояния для [М79 


Доступ 


Только чтение 


Только чтение 


Только чтение 


Только чтение 


Только чтение 


Только чтение 


Только чтение 


Только чтение 


Описание 


Линия 0. Установка бита в 1 указывает на выход текущего 
значения из заданного диапазона 


Линия 1. Установка бита в 1 указывает на выход текущего 
значения из заданного диапазона 


Линия 2. Установка бита в 1 указывает на выход текущего 
значения из заданного диапазона 


Линия 3. Установка бита в 1 указывает на выход текущего 
значения из заданного диапазона 


Температура. Установка бита в 1 указывает на выход те- 
кущего значения из заданного диапазона 


Установка бита в 1 указывает то, что произошло преры- 
вание от датчика температуры (1М75) 


Первый вентилятор. Установка бита в 1 указывает на вы- 
ход текущего значения из заданного диапазона 


Второй вентилятор. Установка бита в 1 указывает на вы- 
ход текущего значения из заданного диапазона 


Таблица 16.12. Формат первого регистра состояния для 1[М80 


Доступ 


Только чтение 


Только чтение 


Только чтение 


Только чтение 


Только чтение 


Только чтение 


Описание 


Линия 0. Установка бита в 1 указывает на выход текущего 
значения из заданного диапазона 


Линия 1. Установка бита в 1 указывает на выход текущего 
значения из заданного диапазона 


Линия 2. Установка бита в 1 указывает на выход текущего 
значения из заданного диапазона 


Линия 3. Установка бита в 1 указывает на выход текущего 
значения из заданного диапазона 


Линия 4. Установка бита в 1 указывает на выход текущего 
значения из заданного диапазона 


Линия 5. Установка бита в 1 указывает на выход текущего 
значения из заданного диапазона 
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Таблица 16.12 (окончание) 


Биты Доступ Описание 





6 Только чтение Линия 6. Установка бита в 1 указывает на выход текущего 
значения из заданного диапазона 


7 Только чтение Установка бита в 1 указывает, что на вход поступил сиг- 
нал прерывания 


В табл. 16.13 и 16.14 показан формат вторых регистров состояния (42. или 
02н) для ЕМ79 и 1.М80. Они выполняют те же функции, что и первые реги- 
стры состояния. 


Таблица 16.13. Формат второго регистра состояния для [М79 





Биты Доступ Описание 

0 Только чтение Линия 4. Установка бита в 1 указывает на выход текущего 
значения из заданного диапазона 

1 Только чтение Линия 5. Установка бита в 1 указывает на выход текущего 
значения из заданного диапазона (отрицательные напря- 
жения) 

2 Только чтение Линия 6. Установка бита в 1 указывает на выход текущего 
значения из заданного диапазона (отрицательные напря- 
жения) 

К Только чтение Третий вентилятор. Установка бита в 1 указывает на вы- 
ход текущего значения из заданного диапазона 

4 Только чтение Установка бита в 1 указывает на вскрытие корпуса или 
изъятие из разъема заданного модуля 

5 Только чтение Переполнение Е1РО (через порты хон и хан) 

6 Только чтение Дополнительный цифровой вход. Установка бита в 1 ука- 


зывает, что сигнал прерывания ММ! на входе отсутствует 


7 Только чтение Резерв 





Таблица 16.14. Формат второго регистра состояния для 1ЕМ80 





Биты Доступ Описание 





0 Только чтение Температура. Установка бита в 1 указывает на выход те- 
кущего значения из заданного диапазона (режим уста- 
новлен во втором регистре маски битом 6) 
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Таблица 16.14 (окончание) 


Биты Доступ Описание 


1 Только чтение Температура. Установка бита в 1 указывает, что про- 
изошло прерывание на входе для дополнительного дат- 
чика температуры (например, 1 М75 или [М99) 


2 Только чтение Первый вентилятор. Установка бита в 1 указывает на вы- 
ход текущего значения из заданного диапазона 


З Только чтение Второй вентилятор. Установка бита в 1 указывает на вы- 
ход текущего значения из заданного диапазона 


4 Только чтение Установка бита в 1 указывает на вскрытие корпуса или 
изъятие из разъема заданного модуля 


5 Только чтение Температура. Установка бита в 1 указывает на выход те- 
кущего значения из заданного диапазона (режим уста- 
новлен во втором регистре маски битом 7) 


6 Только чтение Резерв 


7 Только чтение Резерв 





В табл. 16.15 и 16.16 показан формат первых регистров маски ЗМГ (4зв или 
озв) для 1М79 и ЕМ80. Они позволяют отключить генерацию прерываний 
для заданной линии. Эти регистры удобно использовать для временного 
выключения мониторинга за отдельными линиями (например, температуры 
или напряжения питания), а также для получения текущего состояния бло- 
кировок. 


Таблица 16.15. Формат первого регистра маски для [М79 





Биты Доступ Описание 

0 Запись Линия 0. Установка бита в 1 блокирует прерывание для 
и чтение данной линии 

1 Запись Линия 1. Установка бита в 1 блокирует прерывание для 
и чтение данной линии 

2 Запись Линия 2. Установка бита в 1 блокирует прерывание для 
и чтение данной линии 

З Запись Линия 3. Установка бита в 1 блокирует прерывание для 
и чтение данной линии 

4 Запись Температура. Установка бита в 1 блокирует прерывание 
и чтение для данной линии 

5 Запись Первый вентилятор. Установка бита в 1 блокирует 


и чтение прерывание для данной линии 
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Таблица 16.15 (окончание) 


Биты Доступ Описание 
6 Запись Второй вентилятор. Установка бита в 1 блокирует преры- 
и чтение вание для данной линии 
7 Запись Резерв 
и чтение 


Таблица 16.16. Формат первого регистра маски для [М80 


Биты Доступ Описание 

0 Запись Линия 0. Установка бита в 1 блокирует прерывание 
и чтение для данной линии 

1 Запись Линия 1. Установка бита в 1 блокирует прерывание 
и чтение для данной линии 

2 Запись Линия 2. Установка бита в 1 блокирует прерывание 
и чтение для данной линии 

К Запись Линия 3. Установка бита в 1 блокирует прерывание 
и чтение для данной линии 

4 Запись Линия 4. Установка бита в 1 блокирует прерывание 
и чтение для данной линии 

5 Запись Линия 5. Установка бита в 1 блокирует прерывание 
и чтение для данной линии 

6 Запись Линия 6. Установка бита в 1 блокирует прерывание 
и чтение для данной линии 

7 Запись Установка бита в 1 блокирует прерывание на цифровом 
и чтение входе для любого подключенного устройства 


В табл. 16.17 и 16.18 показан формат вторых регистров маски ЗМТ (44в или 
о4ь) для 1М79 и 1М80. Регистры выполняют те же функции, что и первые 
два регистра маски. 


Таблица 16.17. Формат второго регистра маски для [М79 


Биты Доступ Описание 
0 Запись Линия 4. Установка бита в 1 блокирует прерывание 
и чтение для данной линии 
1 Запись Линия 5. Установка бита в 1 блокирует прерывание 


и чтение для данной линии (отрицательные напряжения) 
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Таблица 16.17 (окончание) 





Биты Доступ Описание 
2 Запись Линия 6. Установка бита в 1 блокирует прерывание 
и чтение для данной линии (отрицательные напряжения) 
3 Запись Третий вентилятор. Установка бита в 1 блокирует преры- 
и чтение вание для данной линии 
4 Запись Вскрытие корпуса или изъятие из разъема заданного 
и чтение модуля. Установка бита в 1 блокирует прерывание 
для данной линии 
5 Запись Переполнение Н!РО. Установка бита в 1 блокирует пре- 
и чтение рывание для данной линии 
6 Запись Дополнительный цифровой вход. Установка бита в 1 бло- 
и чтение кирует прерывание для данной линии 
7 Запись Сброс. Установка этого бита в 1 позволяет сбросить 
и чтение настройки для регистра конфигурации 
Таблица 16.18. Формат второго регистра маски для [М80 
Биты Доступ Описание 
0 Запись Температура. Установка бита в 1 блокирует прерывание 
и чтение для данной линии 
1 Запись Температура. Установка бита в 1 блокирует прерывание 
и чтение на входной линии для дополнительного датчика темпера- 
туры (например, [М75 или 1М99) 
2 Запись Первый вентилятор. Установка бита в 1 блокирует 
и чтение прерывание для данной линии 
З Запись Второй вентилятор. Установка бита в 1 блокирует 
и чтение прерывание для данной линии 
4 Запись Вскрытие корпуса или изъятие из разъема заданного 
и чтение модуля. Установка бита в 1 блокирует прерывание для 
данной линии 
5 Запись Температура (12-разрядное представление). Установка 
и чтение бита в 1 блокирует прерывание для данной линии 
6 Запись Режим прерывания по температуре. При установке в ноль 
и чтение прерывание генерируется, если нарушен заданный диа- 


пазон, а сигнал прерывания будет сброшен. Если значе- 
ние температуры остается вне диапазона, прерывание 
будет выдано повторно. Если бит установлен в 1, то пре- 
рывание будет выдано только один раз при выходе зна- 
чения температуры из заданного диапазона 
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Биты Доступ 
7 Запись 
и чтение 
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Таблица 16.18 (окончание) 


Описание 


То же самое, но для 12-разрядного представления тем- 
пературы 


В табл. 16.19 и 16.20 показан формат регистров маски ММГ (45. и 461) для 
ГМ79. Регистр выполняет те же функции, что и первый регистр маски $М. 


Таблица 16.19. Формат первого регистра маски ММ! для Е М79 


Биты Доступ 
0 Запись 
и чтение 

1 Запись 
и чтение 

2 Запись 
и чтение 

К Запись 
и чтение 

4 Запись 
и чтение 

5 Запись 
и чтение 

6 Запись 
и чтение 

7 Запись 
и чтение 


Описание 


Линия 0. Установка бита в 1 блокирует прерывание для 
данной линии 


Линия 1. Установка бита в 1 блокирует прерывание для 
данной линии 


Линия 2. Установка бита в 1 блокирует прерывание для 
данной линии 


Линия 3. Установка бита в 1 блокирует прерывание для 
данной линии 


Температура. Установка бита в 1 блокирует прерывание 
для данной линии 


Температура. Установка бита в 1 блокирует прерывание 
на входной линии для дополнительного датчика темпера- 
туры (например, [М75 или 1М99) 


Первый вентилятор. Установка бита в 1 блокирует преры- 
вание для данной линии 


Второй вентилятор. Установка бита в 1 блокирует преры- 
вание для данной линии 


Таблица 16.20. Формат второго регистра маски ММ! для [М79 


Биты Доступ 
0 Запись 

и чтение 

1 Запись 

и чтение 

2 Запись 

и чтение 


Описание 


Линия 4. Установка бита в 1 блокирует прерывание для 
данной линии 


Линия 5. Установка бита в 1 блокирует прерывание для 
данной линии (отрицательные напряжения) 


Линия 6. Установка бита в 1 блокирует прерывание для 
данной линии (отрицательные напряжения) 
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Таблица 16.20 (окончание) 


Биты Доступ Описание 

3 Запись Третий вентилятор. Установка бита в 1 блокирует преры- 
и чтение вание для данной линии 

4 Запись Вскрытие корпуса или изъятие из разъема заданного 
и чтение модуля. Установка бита в 1 блокирует прерывание для 

данной линии 

5 Запись Переполнение Е!РО. Установка бита в 1 блокирует пре- 
и чтение рывание для данной линии 

6 Запись Дополнительный цифровой вход. Установка бита в 1 
и чтение блокирует прерывание для данной линии 

7 Запись Сброс. Установка этого бита в 1 на время более 20 мс 
и чтение позволяет сбросить блокировку для вскрытия корпуса 


В табл. 16.21 показан формат регистра делителя (47.) для 1.М79. Регистр 
позволяет установить значения делителя для управления оборотами венти- 
ляторов. 

Таблица 16.21. Формат регистра делителя для [М79 


Биты Доступ Описание 


0—3 Только чтение Для некоторых процессоров Репйит сюда записывается 
напряжение питания (младшие 4 бита) 


4—5 Запись Первый вентилятор. Возможны следующие значения: 
и чтение 005 — 1, 015 — 2, 105 —4и11ъ-—8 

6—7 Запись Второй вентилятор. Возможны следующие значения: 
и чтение 005 = 1, 015 —2, 105 — 4 и11ъ — 8 


В табл. 16.22 показан формат регистра делителя (051) для 1М80. Регистр 
предназначен для настройки оборотов вентиляторов и установки 12-разряд- 
ного представления для температуры. 


Таблица 16.22. Формат регистра делителя для [М80 





Биты Доступ Описание 
0 Запись Выбор первого вентилятора. Установка бита в 1 позволя- 
и чтение ет выбрать уровень чувствительности вентилятора, а за- 


пись 0 — прочитать значение делителя 
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Таблица 16.22 (окончание) 


Биты Доступ Описание 
1 Запись Выбор второго вентилятора. Установка бита в 1 позволяет 
и чтение выбрать уровень чувствительности вентилятора, а запись 
0 — прочитать значение делителя 
2—3 Запись Установка делителя для первого вентилятора. Возможны 
и чтение следующие значения: 005 — 1, 016 — 2, 105 — 4 и 11ъ — 8 
4—5 Запись Установка делителя для второго вентилятора. Возможны 
и чтение следующие значения: 00 — 1, 01ь— 2, 105 —4и 115 — 8 
6 Запись Выбор режима для 12-разрядного представления 
и чтение температуры (бит должен быть установлен в 1) 
7 Запись Резерв 
и чтение 


В табл. 16.23 показан формат регистра Зепма| Виз (48) для 1М79. Регистр 
позволяет указать адрес регистра на шине Зена! Влз. 


Таблица 16.23. Формат регистра Зепа! Виз для [М79 


Биты Доступ Описание 
0—6 Запись и чтение Адрес регистра Зепа! Виз 
7 Только чтение Резерв 


В табл. 16.24 показан формат регистра сброса (49) для 1М79. Регистр по- 
зволяет выполнить сброс микросхемы. После включения питания в регистре 
записано значение 1100000хЪ. 


Таблица 16.24. Формат регистра Зепа! Виз для [ЕМ79 


Биты Доступ Описание 
0 Только чтение Старший бит (5) для напряжения питания процессора 
1—4 Только чтение Резерв 


5 Запись Установка бита в 1 позволит выполнить сброс микросхемы 
и чтение 


Только чтение Резерв 


7 Только чтение Идентификатор |-М79 (как и для [М78 равен 0) 


В табл. 16.25 показан формат регистра температуры (061) для Г.М80. Регистр 
управляет чувствительностью измерения температуры. После включения 
питания в регистре записано значение 00000001. 
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Биты 


0 Только чтение 


Доступ 


Запись 
и чтение 


Запись 
и чтение 


Запись 
и чтение 


Запись 
и чтение 
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Таблица 16.25. Формат регистра температуры для Е М80 


Описание 


Состояние режима  12-разрядного — представления 
температуры 


Полярность температуры (1 — выше нуля, 0 — ниже нуля) 


При установке в 0 используется режим генерации одного 
прерывания при нарушении заданных границ, иначе (1) 
прерывание генерируется постоянно, пока текущее зна- 
чение температуры выходит за установленные пределы 


Установка режима обработки температуры (0 — 8-раз- 
рядные преобразования, 0 — 11-разрядные преобразова- 
ния) 


Сюда записываются 4 младших бита для 11-разрядного 
положительного значения температуры, а для 8-разряд- 
ных значений температуры в бит 7 записывается знак 
плюса 


Теперь осталось рассмотреть регистры данных, которые позволяют считы- 
вать и устанавливать параметры всех линий мониторинга оборудования. 
Список и назначение регистров данных для 1М79 показаны в табл. 16.26, а 
для [М80 — в табл. 16.27. Линии 0—6 применяются для считывания напря- 
жений блока питания компьютера. Обычно они распределены следующим 
образом: линия 0 — +2,5 В, линия 1 — +2,5 В, линия 2 — +3,3 В, линия 
3 — +5 В, линия 4 — +12 В, линия 5 — -12 В и линия 6 — -5 В. 


Номер 
регистра 


208 
218 
221 
23в 


24в 


Таблица 16.26. Список регистров данных для ЕМ79 


Назначение 


Чтение линии 0 

Чтение линии 1 

Чтение линии 2 

Чтение линии 3 

Чтение линии 4 

Чтение линии 5 (отрицательное напряжение) 
Чтение линии 6 (отрицательное напряжение) 
Чтение температуры 


Чтение текущего значения счетчика первого вентилятора 
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Таблица 16.26 (окончание) 





Номер 





регистра Назначение 
298 Чтение текущего значения счетчика второго вентилятора 
2АВ Чтение текущего значения счетчика третьего вентилятора 
2ВВ Установка максимального значения для линии 0 
2СВ Установка минимального значения для линии 0 
208 Установка максимального значения для линии 1 
2ЕВ Установка минимального значения для линии 1 
2ЕВ Установка максимального значения для линии 2 
зов Установка минимального значения для линии 2 
318 Установка максимального значения для линии 3 
328 Установка минимального значения для линии 3 
З3в Установка максимального значения для линии 4 
34в Установка минимального значения для линии 4 
358 Установка максимального значения для линии 5 
з6в Установка минимального значения для линии 5 
378 Установка максимального значения для линии 6 
з8в Установка минимального значения для линии 6 
39в Установка предельного значения температуры 
ЗАВ Установка минимального значения температуры 
ЗВВ Установка предельного значения счетчика первого вентилятора 
зсв Установка предельного значения счетчика второго вентилятора 
ЗрВ Установка предельного значения счетчика третьего вентилятора 
ЗЕВ-— ЗЕВ Резерв 
Таблица 16.27. Список регистров данных для [М80 
Мы Назначение 
208 Чтение линии 0 
218 Чтение линии 1 
228 Чтение линии 2 
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Номер 
регистра 


236 
24В 
256 
261 
278 
285 
291 
2АВ 
2ВВ 
2СВ 
206 


2ЕВ 


зов 


Таблица 16.27 (окончание) 


Назначение 


Чтение линии 3 

Чтение линии 4 

Чтение линии 5 (отрицательное напряжение} 

Чтение линии 6 (отрицательное напряжение} 

Чтение температуры 

Чтение текущего значения счетчика первого вентилятора 

Чтение текущего значения счетчика второго вентилятора 

Установка максимального значения для линии 0 

Установка минимального значения для линии 0 

Установка максимального значения для линии 1 

Установка минимального значения для линии 1 

Установка максимального значения для линии 2 

Установка минимального значения для линии 2 

Установка максимального значения для линии 3 

Установка минимального значения для линии 3 

Установка максимального значения для линии 4 

Установка минимального значения для линии 4 

Установка максимального значения для линии 5 

Установка минимального значения для линии 5 

Установка максимального значения для линии 6 

Установка минимального значения для линии 6 

Установка предельного значения температуры (8-разрядное значение} 
Установка минимального значения температуры (8-разрядное значение} 
Установка предельного значения температуры (12-разрядное значение} 
Установка минимального значения температуры (12-разрядное значение) 
Установка предельного значения счетчика первого вентилятора 
Установка предельного значения счетчика второго вентилятора 


Резерв 





536 Часть |. Работа с аппаратными ресурсами в И/пдоиз 


Внешний датчик температуры может быть выполнен (в нашем контексте) на 
базе микросхем [.М75, [М83, М87, 1.М90, 1М92 или 1М99. Поскольку их 
параметры (чувствительность и время срабатывания) различаются, я не ста- 
ну здесь рассматривать каждый из них, вы самостоятельно можете получить 
нужную информацию в Интернете. Я расскажу только о температурном дат- 
чике [/М75. Он представляет собой отдельную микросхему для измерения 
температуры в диапазоне от —55 до +125 °С. Микросхема содержит общий 
управляющий регистр (чтение и запись), через который можно выбирать 
дополнительные регистры для чтения или записи. Формат общего регистра 
показан в табл. 16.28. 


Таблица 16.28. Формат общего регистра для [М75 






Описание Выбор регистра 


Приведем некоторые комментарии к табл. 16.28. 


О Биты 2—7 не используются и должны быть установлены в 0. 


С Биты 0—1 определяют номер дополнительного регистра. Возможны сле- 
дующие значения: 006 — регистр температуры, 01ь — регистр конфигу- 
рации, 105 — регистр предельного значения‘ гистерезиса температуры, 
11ь — регистр стандартного значения температуры. 


Регистр температуры доступен только для чтения и имеет размер 16 бит. 
Используются только старшие 8 бит (7—15). Установка 0 бита в | определя- 
ет значение температуры в 0,5 °С. 


Регистр конфигурации доступен для чтения и записи. Он имеет размер 
8 бит. Формат регистра показан в табл. 16.29. 


Таблица 16.29. Формат регистра конфигурации для [М75 


о А СЯ Е СИ ИЕ 
оон [о Го о лены ось рений пе 


Приведем краткое описание таблицы. 





О Бит 0, установленный в 1, позволяет выключить подачу напряжения к 
микросхеме [.М75. 


О Бит 1 определяет режим работы микросхемы: | — генерировать прерыва- 
ния, 0 — режим сравнения значений. 


О Бит 2 позволяет установить полярность измерений (1 — выше нуля, 0 — 
ниже нуля). 
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О Биты 3—4 позволяют установить количество обнаруженных дефектов пе- 
ред выходом в рабочий режим, которые будут игнорироваться. Для за- 
вершения процесса инициализации микросхемы достаточно 100 мс. 


С Биты 5—7 должны быть установлены в 0. 


Регистры установки предельного значения гистерезиса температуры и стан- 
дартного значения температуры доступны для чтения и записи. Они имеют 
размер 16 бит, хотя используются только старшие 8 бит (7—15). По умолча- 
нию значение предельного гистерезиса температуры равно 80 °С, а стан- 
дартное значение — 75 °С. 


Вот и все основные сведения о температурном датчике. Теперь рассмотрим 
примеры программирования функций мониторинга системы. Вначале вы- 
полним сброс и последующую инициализацию микросхемы, как показано в 
листинге 16.1. Хочу заметить, что для считывания текущих значений темпе- 
ратуры, напряжений и оборотов вентилятора выполнять инициализацию не 
нужно. Это делается только в том случае, если вы хотите перенастроить па- 
раметры микросхемы по-новому или когда микросхема не отвечает. 





Те 1М79 ргос 
; выполняем сброс микросхемы 


хог АХ, АХ ; обнуляем регистр 

поу ОХ, 2901 ; номер базового порта 

; выбираем регистр конфигурации 40: 

ааа ох, 5 ; регистр адреса х5П 

поу АБ, 401 ; номер регистра конфигурации 





опЕ ОХ, АБ ; записываем значение в порт 

; записываем значение инициализации в регистр данных х6бП 
с ОХ ; регистр данных хбВ 

поу АБ, 801 ; код инициализации 

опЕ ОХ, АБ ; записываем значение в порт 

; проверяем наличие микросхемы мониторинга 

дес ОХ, 1 ; регистр адреса х5П 

поу АБ, 40 ; номер регистра конфигурации 

оф ОХ, АБ ; записываем значение в порт 


; читаем значение регистра конфигурации 401 из порта данных хбВ 
шс ОХ ; регистр данных х6В 

1 АБ, ОХ ; читаем байт из порта 

спр АЬ, 08} ; если результат не равен 08}, 

)Зпе МО МОМТТОВ; микросхема мониторинга отсутствует 

; выполняем инициализацию микросхемы 

дес ОХ ; регистр адреса х5й 
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й 


. 


: 


регистр ЗМТ 1 
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записываем значение в порт 


значение по умолчанию для регистра ЗМТ 1 


регистр данных х6бЬ 


записываем значение в порт 
регистр адреса х5й 


регистр $МТ 2 


записываем значение в порт 


значение по умолчанию для регистра $ЗМТ 2 


регистр данных хбП 


записываем значение в порт 


регистр адреса х5П 


регистр ММТ 1 


записываем значение в порт 


значение по умолчанию для регистра ММТ 1 


регистр данных х6бВ 


записываем значение в порт 


регистр адреса х5в 


регистр ММГ 2 


записываем значение в порт 


значение по умолчанию для регистра ММТ 2 


регистр данных хбП 


записываем значение в порт 


; запускаем мониторинг системы 


; регистр адреса х5В 
; номер регистра конфигурации 


’ 


записываем значение в порт 


; читаем значение регистра конфигурации 40. из порта данных хбП 





по\ АБ, 4ЗП 
оцЕ ВХ, АБ 
шоу АЦ, ОРЕЙ 
1пс ОХ 

оцЕ ОХ, АЬ 
аес Ох 

пох АБ, 448 
оцЕ ОХ, АБ 
пох АБ, ОЕЕБ 
з1пс ОХ 

оцЕ БХ, АБ 
аес ВХ 

шоу АЦ, 45В 
оцЕ ВХ, АБ 
поу АБ, ОЕРЕК 
з1пс ОХ 

оиЕ ОХ, АБ 
аес ВХ 

шоу Аь, 46. 
оцЕ ВХ, АБ 
поу АБ, ОЕЕБ 
з0с ОХ 

очЕ ОХ, АЁ 
аес ПХ, 1 
поу АЦ, 400 
оцЕ ОХ, А 
1пс ОХ 

10 АБ, ОХ 
ог АБ, 015 
пох ВЫ, 088 
поЕ ВЫ 

апа АТ, ВЫ 
ог АБ, 041 
пох ВЫ, 208 
поЕ ВЬ 

апа АГ, ВЬ 
поУу АН, АБ 


. 


; 


регистр данных х6И 


читаем байт из порта 


устанавливаем бит 1 для включения мониторинга 


копируем значение 


инверсия 


разрешаем прерывания 


определяем генерацию ММТ прерываний 


копируем значение 


инверсия 


выбираем прерывания ТВО 


временно сохраняем значение 


; сохраняем новое значение байта конфигурации 
; регистр адреса х5В 
; номер регистра конфигурации 


аес ПХ, 1 
пох АЁ, 401 
ое ПОХ, АБ 


й 


записываем значение в порт 
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; записываем значение инициализации в регистр данных х6В 
1пс 5Х ; регистр данных хбП 

поту АБ, АН ; байт конфигурации 

сиё ОХ, АБ ; записываем значение в порт 

геё 

Тп1е 1М79 епар 


Аналогичный пример для С++ показан в листинге 16.2. 


: Листинг 16.2. Инициализация микросхемы мониторинга в С++ 


// пишем функцию инициализации микросхемы №М79 
Боо1 Тиле 1М79 (} 
{ 
01519пеЧ 10 иВазеРоге = 0х290; // номер базового порта 
РМОВР амВези1е = 0; 
// выполняем сброс микросхемы 
// выбираем регистр конфигурации 40% 
ОцЕРогЕ ( чВазеРог®е + 5, 0х40, 1); 
// записываем значение инициализации в регистр данных х6бЫ 
оцЕРогЕ ( иВазеРогЕ + 6, 0х80, 1); 
// проверяем наличие микросхемы мониторинга 
// выбираем регистр конфигурации 40% 
ОпЕРОГЕ ( аВазеРогЕ + 5, 0х40, 1); 
// читаем значение регистра конфигурации 40% из порта данных хбИ 
1пРогЕ ( чВазеРогЕ + 6, &амВезо1%, 1); 
// если полученное значение не равно 0х08, микросхема отсутствует 
1Е ( дВезо1Е != 0х08) гебахп Еа1зе; 
// выполняем инициализацию микросхемы 
// значение по умолчанию для регистра 5МТ 1 
// выбираем регистр $МТ 1 
оиЕРОГЕ ( иВазеРог® + 5, 0х43, 1); 
// записываем значение инициализации в регистр данных х6бВ 
очЕРоге ( иВазеРогЕ + 6, ОхЕЕ, 1); 
// выбираем регистр ЭМТ 2 
ОИЕРОГЕ ( иВазеРогЕ + 5, 0х44, 1); 
// записываем значение инициализации в регистр данных х6П 
очЕРогЕ ( чВазеРогЕ + 6, ОхЕЕ, 1); 
// выбираем регистр ММТ 1 
ОНЕРогеЕ ( иВазеРогЕ + 5, 0х45, 1); 
// записываем значение инициализации в регистр данных хбИ 
ОЧЕРОГЕ ( иВазеРоге + 6, ОхЕЕ, 1); 
// выбираем регистр ММТ 2 
оЧЕРогЕ ( иВазеРогЕ + 5, 0х46, 1); 
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// записываем значение инициализации в регистр данных х6бИ 
оцЕРохе ( иВазеРог® + 6, ОхЕЕ, 1); 

// запускаем мониторинг системы 

// выбираем регистр конфигурации 40% 

оцЕРохЕ ( иВазеРог® + 5, 0х40, 1); 

// читаем значение регистра конфигурации 40} из порта данных хбЬ 
1оРоге ( аВазеРоге + 6, &АЧмВези1%, 1); 

// устанавливаем бит 1 для включения мониторинга 

ЧмКези1е |= 0х01; 

// разрешаем прерывания 

ЧмВези1Е & = -(0х08); 

// определяем генерацию ММТ прерываний 

ЧмКези1е |= 0х04; 

// выбираем прерывания ТВО 

ЧмВези1 & = -(0х20); 

// записываем значение в регистр конфигурации 

// выбираем регистр конфигурации 40 

очЕРоге ( иВазеРоге + 5, 0х40, 1); 

// записываем значение инициализации в регистр данных х6бЬ 
оцЕРоге ( иВазеРохЕ + 6, ЧмВезо1е, 1); 

тефагп &гиае; // выходим из функции 


Для того чтобы остановить процесс мониторинга, можно применить код из 
листинга 16.3. 


ЗЕор_1М79 ргос 

хог АХ, АХ ; обнуляем регистр 

хог ВХ, ВХ ; обнуляем регистр 

пох ОХ, 2901 ; номер базового порта 

; выбираем регистр конфигурации 401 

ааа ох, 5 ; регистр адреса х5\ 

оу АЬ, 40й $; номер регистра конфигурации 

оцЕ ОХ, АБ ; Записываем значение в порт 

; читаем значение регистра конфигурации 40} из порта данных хбй 





1пс ОХ ; регистр данных хбИ 

1п АБ, ОХ ; получаем байт из порта 

моу ВЬ, 01 ; копируем значение для остановки мониторинга 
пое ВЬ ; инверсия 

апа АГ, ВЬ ; бит 0 регистра конфигурации сбрасываем в 0 


поу АН, АБ ; сохраняем значение 
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; сохраняем новое значение байта. конфигурации 
дес РХ ; регистр адреса х5В 

поу АБ, 401 ; номер регистра конфигурации 
оц& ОХ, АБ ; записываем значение в порт 

10с ОХ ; регистр данных х6бП 

поу АБ, АН ; копируем сохраненное значение 
оп ОХ, АБ ; записываем значение в порт 

тее 

З6ор 1М79 епар 


Аналогичный пример для С++ показан в листинге 16.4. 


Листинг 16.4. Остановка процесса мониторинга в С++ 


// пишем функцию для остановки процесса мониторинга 
уо1а 5*ор 1М79 () 
{ 
ипз1дпеЯ 1пе иВазерРог+ = 0х290; // номер базового порта 
ОМОВР @мВези1% = 0; 
// выбираем регистр конфигурации 408 
ооЕРоге ( цВазеРог® + 5, 0х40, 1); 
// читаем значение регистра конфигурации 40, из порта данных хбП 
10Рогё ( чВазеРог® + 6, &амВезо1&, 1); 
// бит 0 регистра конфигурации сбрасываем в 0 
ФВези1% & = -(0х01); 
// сохраняем новое значение байта конфигурации 
оцЕРоге ( чВазеРок* + 5, 0х40, 1); 
оиЕРогЕ ( иВазеРог® + 6, ЯамВези1&, 1); 


А теперь рассмотрим пример, позволяющий получить текущее значение 
оборотов вентилятора (листинг 16.5). 





‚ Листинг 16.5. Получение текущего значения оборотов вентилятора 


; переменная для хранения числа оборотов 

Соо1ег_ Сочо® ам ? 

; общий код программы 

беё Соо]1егбреея ргос 

хог ЕАХ, ЕАХ ; обнуляем регистр 

хог ЕВХ, ЕВХ ; обнуляем регистр 

поу ОХ, 290. ; номер базового порта 

; получаем текущее значение счетчика из регистра 288 
ааа ох, 5 ; регистр адреса х5В 
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поу АБ, 282 ; номер регистра счетчика для первого вентилятора 
©ифЕ ОХ, АБ ; записываем значение в порт 

10с ОХ ; регистр данных хбП 

102 АБ, ОХ ; получаем байт из порта 

; проверяем, крутится ли он вообще 

сир АЬ, ОЕРЕВ ; если значение АГ равно РЕП, 

)е СООБЕВ_5ТОРРЕО; вентилятор не крутится или сгорел 


поу ВЬ, АБ ; сохраняем значение 

; получаем значение делителя из регистра 478 
Чес 0Х ; регистр адреса х5п 

поу АБ, 472 ; номер регистра делителя 

оц ОХ, АБ ; записываем значение в порт 
10с 0Х ; регистр данных хбП 


10 АБ, ОХ ; получаем байт из порта 
; выделяем значение делителя для первого вентилятора 


51е АБ, 4 ; сдвигаем вправо на 4 разряда 
апа АЬ, 3 ; выделяем нужное 
501 АБ, 1 ; сдвигаем обратно на один разряд 


; если значение счетчика равно 0, устанавливаем его в 1 

стр ВЫ, 0 ; если 0, 

32 СОЧМТ МО; передаем управление для установки не нулевого значения 
Ча1ее: 

; считаем обороты вентилятора 

пот ВЬ ; умножаем АГ на ВЬ 

поу ВХ, АХ ; копируем результат в ВХ 

пох ЕАХ, 1499701; заносим константное значение 1 350 000 

Ч1у ВХ ; делим 

поу Соо1ег Соипе, АХ; сохраняем значение в переменную 


ге 
СООМТ_ МО: 
ааа в, 1 ; увеличиваем до 1 


]пр 5зБогф Ча1ее; возвращаемся назад 
Сеф_ Соо1егбрее@ епар 


В листинге 16.6 показан аналогичный пример для С++. 





// пишем функцию для определения числа оборотов для вентилятора 
005191еЯ 1пе беф Соо1егЗрееа ( ип5$19пеа 116 иСоо1ег) 
{ 
и15190теа 106 иВазеРогЕ = 0х290; // номер базового порта 
и0$19пеа 1406 иСиггепеСоипбегк = 1; // счетчик 
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ип519реЯя 106 иСаскепЕр1у = 0; // делитель 
ОМОВО 9мВези1* = 0; 
1Е ( ( оСоо1ег < 1) || ( оСоо1ег > 3)) хгебаго 0; 
// получаем текущее значение счетчика из регистра 288 
оЧЕРоге ( чВазеРог® + 5, 0х28, 1); 
// читаем значение регистра конфигурации 281 из порта данных хбВ 
1оРохге ( чВазеРог® + 6, &@мВези1&, 1); 
// сохраняем его в переменную 
эСиггепеСоспеег = 9мВе5о1%; 
// проверяем, крутится ли вообще вентилятор 
1Е ( оСихгереСочосек == ОхЕРЕ) 
хесогп 0; // вентилятор не крутится или сгорел 
// получаем значение делителя из регистра 478 
оЧЕРоге ( пВазеРог® + 5, 0х47, 1); 
// читаем значение регистра делителя 47. из порта данных хбН 
3пРогеЕ ( аВазеРохЕ + 6, &ЧмВези1*, 1); 
// выделяем значение делителя для указанного вентилятора 
змтесВ ( иСоо1ег) 
{ 


сазе 1: 


аСиххеп® 1х 
ЬгеаКк; 

сазе 2: 
иСиххеп руху 
ргеак; 

сазе 3: 
иСоггсепеО1у = 2; // всегда постоянное значение 
Ьгеак; 

} 

// считаем количество оборотов в минуту для вентилятора 

// и выходим из функции 

хесигп (1 350 000 / ( иСиггепеСомпеег * аСаггеп®015)); 


1 << 4 ( амВеза\ >> 4) & 0х03); 


1 << ( ( амчВезо1* >> 6) & 0х03); 


Для установки нового значения оборотов вентилятора можно применить 
код из листинга 16.7. 





‚Листинг 16. -7. ‚ Установка нового значения ‘оборотов для первого вентилятора. 


; Задаем делитель частоты равным 4 
01у_Соо1ек & 2 

; общий код программы 

Зее Соо1егбреея ргос 

хог ЕАХ, ЕАХ ; обнуляем регистр 
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хог ЕВХ, ЕВХ ; обнуляем регистр 

шоу ОХ, 2901 ; номер базового порта 

; получаем текущее значение из регистра 478 
ааа 0х, 5 ; регистр адреса х5В 

поу АБ, 476 ; номер регистра делителя 

оиф ОХ, АБ ; записываем значение в порт 


10с ОХ ; регистр данных хбП 

11 АБ, БХ ; получаем байт из порта 

поу ВЬ, 3 ; копируем значение для удобства расчетов 
551 ВЫ, 4 ; выделяем разряды 

поЕ ВЫ ; инверсия 


апа АГ, ВЬ ; копируем в АЁ с преобразованием 
поу ВЬ, О1у_Соо1ег; копируем делитель 

551 ВЬ, 4 ; сдвигаем влево 

ог АБ, ВЬ ; Объединяем с АБ 

поу ВЬ, АБ ; временно сохраняем 

; записываем результат в регистр делителя 

Аес ОХ ; регистр адреса х5в 

поу АБ, 471 ; номер регистра делителя 

ои= ОХ, АБ ; записываем значение в порт 


10с ОХ ; регистр данных хбВ 

поу АБ, ВЬ ; копируем сохраненное значение 
очЕ ОХ, АБ ; записываем его в порт 

гее 


Зее Соо1егбрееЯ епар 


Аналогичный пример для С++ показан в листинге 16.8. 





Листинг 16.8. Установка нового значения оборотов для первого вентилятора в С++ : 





у01А 5еЕ Соо1егбреея_4 () 
{ 


90$1апеЯ 1пе иВазеРогЕ = 0х290; // номер базового порта 
и0319теа 10 иСиггепёр1у = 2; // делитель 

РМОВР 9мВези1% = 0; 

// получаем текущее значение из регистра 471 

оПЕРоге ( иВазеРог® + 5, 0х47, 1); 

// читаем значение регистра делителя 476 из порта данных хбИ 
1оРог+ ( аВазеРоге + 6, &мВезу1%, 1); 

// выделяем значение делителя для указанного вентилятора 
ЧмВези1Е &= - (3 << 4); 

иСисгепе01у = иСасгерер1у << 4; 

@\Вези1% |= аСиггеп®01у; 
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// записываем результат в регистр делителя 
оцЕРогЕ ( иВазеРоге + 5, 0х47, 1); 

// записываем новое значение в порт данных 
оиЕРокге ( чВазеРоге + 6, @мВезо1%, 1); 


В листинге 16.9 показан способ считывания текущего значения температуры 
материнской платы. 


Листинг 16.9. Получение текущей температуры материнской платы 
МВ ТЕМР 4 ? 

; общий код программы 

бее_МВ Тепр ргос 

хог АХ, АХ ; обнуляем регистр 

моу ОХ, 2901 ; номер базового порта 

; получаем текущее значение из регистра 278 
ааа ох, 5 ; регистр адреса х5в 

моу АБ, 27. ; номер регистра делителя 

ойЕ ОХ, АБ ; записываем значение в порт 
1ш1с ОХ ; регистр данных хбП 

; небольшая пауза 

пот СХ, 5000 ; устанавливаем счетчик 

хог ВХ, ВХ ; обнуляем регистр 

@рачзе: 

ааа вх, сх ; чисто символически 

}оор @рацзе ; повторяем 5000 раз 

Ш АБ ОХ ; получаем байт из порта 

моу МВ _ТЕМР, АГ; копируем значение полученной температуры в переменную 
ге 

бес МВ Тептр епар 


Аналогичный пример для С++ показан в листинге 16.10. 
Листинг 16.10. Получение текущей температуры материнской платы в С++ 
106 бек МВ_Тепр () 


{ 
\151дреа 116 оВазеРогеЕ = 0х290; // номер базового порта 
ОМОВР 9мВе5о1* = 0; 
// получаем текушее значение из регистра 276 
ОНЕРоге ( иВазеРог® + 5, 0х27, 1); 
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// читаем значение температуры из порта данных хбь 
1оРоге ( чВазеРоге + 6, &ЧмВези1%, 1); 
гефагп амВези1{; 

} 

// пример использования функции 

106 1Тетрекаеаке = 0; 

сраг зхТех® [30]; 

// получаем текущее значение температуры 

1Тепрегавиге = беЕ МВ Тепр (); 

5ре1пЕЕ ( з2Техе, "Температура: %2а.00 ", 1Тепрегакаге); 


И последний пример для получения текущих напряжений питания показан 
в листинге 16.11. 


: Листинг 16.11. Получение текущих напряжений питания в С++ 





Е]оаф без _\о1& ( ип519пеЯ 116 ОЕЕзеВеч) 
{ 
1$19пеа 10 оВазеРоге = 0х290; // номер базового порта 
РМОВО ЧмВези1% = 0; 
Боаф ЕВези1е = 0.0000, #1, Е_2; 
// в зависимости от номера регистра, считаем базовое значение 
5и16сЬ ( ОЕЁзеф Вед) 
{ 
сазе 0: // регистр 208 для нулевой линии 
сазе 1: // регистр 211 для первой линии 
сазе 2: // регистр 221 для второй линии 


1 = 0.00; 
2 =0.0; 
Ьгеак; 
сазе 3: // регистр 238 для третьей линии 
У 1 = 2.98; 
ЕУ_2 =5.0; 
Ьгеак; 
сазе 4: // регистр 248 для четвертой линии 
1 = 3.00; 
ЕУ_2 = 12.0; 
Ьгеак; 
сазе 5: // регистр 251 для пятой линии 
1 = 3.00; 


ЕУ2 = -12.0; 
Ьгеак; 
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сазе 5: // регистр 261 для шестой линии 


ЕУ_1 = 3.50; 
ЕУ_2 = -5.0; 
ргеак; 


} 
// получаем текущее значение из регистра 
оЧЕРоге ( цВазеРоге + 5, ОЕЁзефВед, 1); 
// читаем значение напряжения из порта данных хбП 
1пРоге ( чВазеРог® + 6, &АмВези1е, 1); 
// вычисляем значение напряжения 
ЕВези14 = ( 0.016 * ( Е1оа®) ЧмВезо1*) - Е 1 + Е 2; 
гесагп ЕКезо1{; 
) 
// применим функцию на практике 
сраг раЁЕег [300]; 
Ноае ЁСоге, Ёпб5, Ёр5, Е012, ЕЁр12, #633, Е33; 
// получаем значения напряжений 
ЕСоге = Сбеё \о1® (0); 


15 = беф Уо1 (6); 
Ер5 = бе \Уо1* (3); 
112 = беф Уо1% (5); 
Ёр12 = Сбеё \о1* (4); 
Ес33 = беф \о1® (1); 


#33 = Сеё Уо1* (2); 

// форматируем значения в удобочитаемый вид 

зре1пеЕ ( раЕЕег, "Усоге: %2.2Е У \п -5 У: %2.2Е У \п \ 

+5 У: %2.2Е М \п -12 У: %2.2Е У \п +12 У: %2.2Е У \п \ 

3,3 \: %2.2Е У \п 3,3 \: %2.2Е У \п", Еп5, Ёр5, ЁЕ012, ЁЕр12, Ес33, 2Е33); 


На этом можно завершить тему аппаратного мониторинга системы. Сущест- 
вует еще много различных модификаций датчиков, и обо всех рассказать 
просто невозможно. Однако материал этой главы поможет вам самостоя- 
тельно разобраться со всеми другими существующими модулями и сенсора- 
ми. Главное — не забывайте обращаться за обновленной информацией на 
сайты производителей оборудования. 


ГЛАВА 17 


Параллельный 
и последовательный порты 


Последовательный и параллельный Порты так прочно вошли в конфигура- 
цию компьютера, что, несмотря на появление новых высокоскоростных ин- 
терфейсов, продолжают оставаться без изменений и дополнений. Почему 
так происходит и что в них такого особенного? Во-первых, это простота 
исполнения и отработанный годами протокол передачи данных. Во-вторых, 
эти интерфейсы идеально подходят для подключения определенных низко- 
скоростных устройств: модема и принтера. В-третьих, данные порты (осо- 
бенно последовательный) широко применяются для работы со специфи- 
ческим промышленным и научным оборудованием. В-четвертых, в мире 
накопилось так много устройств, использующих эти интерфейсы, что еще 
нескоро производители современных компьютерных систем откажутся от 
НИХ. 


В любом случае мы рассмотрим вопросы программирования параллельных 
и последовательных портов в следующем порядке: 


1. С использованием функций В1О$З. 
2. С использованием аппаратных портов. 


3. С помощью интерфейса \!т32 АРТ. 


17.1. Общие сведения 


Параллельная передача данных построена по принципу одновременной пе- 
редачи 8 битов информации по 8 отдельным линиям (проводам). К тому же 
данные могут передаваться лишь в одном направлении. Для организации 
двунаправленной передачи потребуется специальный кабель и соответст- 
вующее программное обеспечение. 
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В процессе передачи данных (1 байт за один цикл) приемная и передаюшая 
стороны сообщают по специальной линии о своем состоянии. Для этого 
применяются специальные сигналы. Когда устройство (например, принтер) 
занято, оно выдает сигнал возу, а когда программа подготовила байт данных 
для передачи, она передает устройству сигнал зтвовЕ. Существуют также 
специальные линии для контроля передаваемых данных, для сообщения об 
отсутствии бумаги, для передачи сообщений об ошибках и готовности уст- 
ройства. 


Параллельный интерфейс (РТ — пе Римег) в компьютере состоит из 
трех независимых портов: [РТ1, ГРТ2 и ЁРТЗ. Кроме того, имеются три 
основных Типа параллельных портов: стандартный, ЕРР (Епрапсе@ Рага|е! 
Рой) и ЕСР (Ежепаеа СарабИйу Рой). Стандартный порт поддерживает 
только однонаправленную передачу данных (от компьютера к устройству). 
Максимальная скорость передачи может составлять от 120 до 200 Кб/сек. 
Порт ЕРР является двунаправленным и поддерживает скорость передачи 
до 2 Мб/сек. Данный порт позволяет использовать канал прямого доступа к 
памяти (ОМА). Порт ЕСР аналогичен ЕРР, но дополнительно позволяет 
сжимать данные, что еще больше увеличивает общую скорость обмена дан- 
ными. Сжатие реализуется как программно, так и аппаратно. 


Последовательный порт реализован на базе интерфейса К5-232. Как прави- 
ло, компьютер поддерживает до четырех портов: СОМ1, СОМ2, СОМЗ и 
СОМА. Передача данных выполняется побитно в двух направлениях и с 
одинаковой частотой. Передаваемый блок данных в асинхронном режиме 
состоит из стартового бита, битов данных (8) и стоп-бита. Скорость перела- 
чи данных измеряется в бодах (бит в секунду вместе со служебными бита- 
ми) и может иметь следующие значения: 110, 300, 1 200, 2 400, 4 800, 9 600, 
19 200, 38 400, 57 600 и 115 200. Если два устройства (модема) имеют разные 
скорости передачи, будет использована наименышая из них. Стартовый’ и 
стоп-бит определяют начало и окончание блока данных. Дополнительно для 
выявления ошибок передачи добавляется бит четности. Его использование 
имеет три режима: без бита четности (М№ о Рагйу), нечетный бит четности 
(Оаа Рашу) и четный бит четности (Еуеп Рагйу). Перед началом передачи 
данных следует выполнить настройку и инициализацию обоих устройств. 


17.2. Использование функций ВО $ 


17.2.1. Работа с параллельным портом 


Поддержка параллельного порта В1О$ выполняется с помошью прерывания 
1пЕ 175. Существуют всего три стандартные функции, предназначенные для 
работы с этим портом. Рассмотрим их по порядку. 
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17.2.1.1. Функция 00В 


Эта функция позволяет передать на принтер один символ. 


Использование: 
1. В регистр Ан следует поместить код функции оон. 


2. В регистр Аъ следует записать код символа (в том числе и управляющий). 
3. В регистр ох записывается порядковый номер порта (0—2). 
4. Вызывается прерывание В10$ 11+ 178. 


Выход: 


После выполнения функции в регистр Ан будет записан результат выполне- 
ния операции в виде битовой маски (табл. 17.1). Как правило, установлен- 
ные биты 4 и 5 сигнализируют о том, что принтер отсутствует на выбран- 
ном порту. 


Таблица 17.1. Коды состояния для функций принтера 
Бит Описание 


0 Тайм-аут или ошибка по времени (1 — ошибка, 0 -- нет ошибки) 
1—2 — Зарезервированы и не используются 
Ошибка ввода-вывода (1 — ошибка, 0 — нет ошибки} 


Выбор принтера (1 — принтер доступен, 0 — принтер недоступен) 


3 

4 

5 Закончилась бумага (1 — нет бумаги) 

6 Подтверждение приема данных (0 — подтверждение есть) 
7 


Готовность принтера (1 — принтер не занят, 0 — принтер занят) 


В реальных условиях обычно проверяется бит 3 (ошибка ввода-вывода). 
Пример вывода строки символов на принтер показан в листинге 17.1. 


Листинг 17.1. Вывод строки символов на принтер 





Меззаче ЧЮ 'ТезЕ1па оЁ Ве рг1пеег$' 


поу ОХ, 0 ; выбираем первый принтер (ТРТ1) 

поу СХ, 23 ; количество символов, которые нужно напечатать 
поу ВХ ОЕЁЕзеф Меззаде 

@Ча1ее: 

поу АН, 0 ; код функции 008 


поу АБ, [ВХ] ; первый символ 
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1аЕ 176 ; вызываем прерывание 

фезЕ АН, 010006; проверяем бит ошибки 

Эп= ЕВВОВ НМО; вызываем обработчик ошибки 
тис ВХ 

1оор @Ч4а1ее ; следующий символ 


Перед началом работы нужно инициализировать принтер (функция 011) и 
только поле этого начинать печать. Если произошла ошибка во время печа- 
ти, следует повторно провести инициализацию устройства. 


17.2.1.2. Функция 01Р 


Функция позволяет инициализировать указанный порт принтера. Данная 
функция должна быть вызвана перед началом работы принтера и далее по 
ходу печати, если возникнут ошибки. 


Использование: 

1. В регистр Ан следует поместить код функции о1ь. 
2. В ох записывается порядковый номер порта (0—2). 
3. Вызывается прерывание ВОЗ 1пе 17ь. 


Выход: 


После выполнения функции в регистр Ан будет записан результат выполне- 
ния операции в виде битовой маски (см. табл. 17.1). Пример инициализа- 
ции порта ЕРТ! представлен в листинге 17.2. 


поУу АН, 1 ; код функции 018 
по\у ОХ, 0 ; выбираем первый принтер (1РТ1) 
116 178 ; вызываем прерывание 


фезЕ АН, 010006; проверяем бит ошибки 
)л= ЕВКОВ_НМО; вызываем обработчик ошибки 


17.2.1.3. Функция 028 


Данная функция позволяет получить информацию о текущем статусе прин- 
тера. 


Использование: 
1. В регистр дн следует поместить код функции 025. 
2. В регистр ох записывается порядковый номер порта (0—2). 


3. Вызывается прерывание ВОЗ 11% 17Ь. 
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Выход: 


После выполнения функции в регистр ан будет записан результат выполне- 
ния операции в виде битовой маски (см. табл. 17.1). 


Вот и все функции для работы с параллельным портом. 


17.2.2. Работа с последовательным портом 


Теперь рассмотрим функции ВЮ$ и прерывание :пе 14., поддерживающие 
программирование последовательного порта. 


17.2.2.1. Функция 00 


Эта функция позволяет инициализировать последовательный порт. Эту 
функцию следует всегда вызывать перед началом работы. 


Использование: 
1. В регистр Ан следует поместить код функции оон. 


2. В ль следует записать байт инициализации. Формат этого байта показан 
в табл. 17.2. 


3. В вх записывается порядковый номер последовательного порта (0—3). 
4. Вызывается прерывание ВТО 1+ 141. 


Таблица 17.2. Формат байта инициализации 


Бит Описание 
0-1 — Размер данных (105 — 7 битов, 115 — 8 битов) 
2 Количество стоповых битов (0 — один, 1 — два) 
3—4 Битчетности (00 — нет, о1ь — нечетный, 105 — нет, 11ь — четный) 


5—7 Скорость передачи (000 — 110 или 19 200 бод, о01ь — 150 или 38 400 бод, 
0105 — 300 бод, 0115 — 600 бод, 1005 — 1200 бод, 101ь-— 2400 бод, 1105 — 
4800 боди 1115 — 9600 бод) 


Выход: 
После выполнения функции в регистр Ан будет записано состояние порта 
(табл. 17.3), а в регистр Ат, — состояние модема (табл. 17.4). 


Таблица 17.3. Формат байта состояния порта 


Бит Описание 


0 Готовность данных (1 — готовы, 0 — не готовы) 


1 Ошибка переполнения данных (1 — есть, 0 — нет) 
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Таблица 17.3 (окончание) 


Бит Описание 

Ошибка четности (1 — есть, 0 — нет) 

Ошибка синхронизации данных (1 — есть, 0 — нет) 

Обнаружен перерыв в передаче данных (1 — да, 0 — нет) 

Регистр хранения данных пустой (1 — нет данных, 0 — есть данные) 


Регистр сдвига пустой (1 — нет данных, 0 — есть данные) 


чоатоъ 


Тайм-аут или ошибка по времени (1 — ошибка, 0 — нет ошибки) 


Таблица 17.4. Формат байта состояния модема 


Бит Описание 


Изменилось состояние на входной линии СТ$ (С!еаг То Зепа): 1 — есть 
Изменилось состояние на входной линии ОЗВ (Ба\а Зе! Веаду): 1 — есть 


0 

1 

2 Изменилось состояние на входной линии Н! (Ртд пасаюг: 1 — есть 

З Изменилось состояние на входной линии ОСО (Ва{а Сашег Ое{ес!: 1 — есть 
4 


Произошел сброс для передачи на входной линии СТЗ (С!еаг То Зепа): 
1 — сброс 


5 Готовность модема для чтения данных на входной линии ОЗВ (Ба Зе 
Веаду): 1 — готов, 0 — не готов 


6 Состояние индикатора звонка на входной линии В! (Втд !пФксаюг): 1 — есть 
сигнал 


7 Сигнал обнаружения несущей на входной линии ОСО (Байа Сащег Оеес\: 
1 — обнаружен 





Пример инициализации последовательного порта СОМ1 представлен в лис- 
тинге 17.3. 





Листинг 17.3. Инициализация последовательного порта СОМ1 


1016 СОМ 1 ргос 

хог АХ, АХ ; обнуляем регистр 

пох АБ, 101000115; 4800 бод, без бита четности, 1 стоп-бит, 8 битов 
оу Ох, 0 ; порт СОМ1 

зп 148 ; вызываем прерывание 

хее 

111 СОМ 1 епар 
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17.2.2.2. Функция 01В 

Функция позволяет записать один символ в последовательный порт. 
Использование: 

1. В регистр Ан следует поместить код функции о1в. 

2. В лр, следует записать код передаваемого символа. 

3. В ох записывается порядковый номер последовательного порта (0—3). 
4. Вызывается прерывание ВОЗ 11% 141. 


Выход: 


После выполнения функции в регистр Ан будет записано состояние порта 
(см. табл. 17.3). Простой пример использования данной функции показан 
в листинге 17.4. 





"Листинг 47. 4. ` Передача. введенного ‹ с ‚ клавиатуры с символа в порт 





; инициализируем порт СОМ2 
са11 Тп1_СОМ_2 
; проверяем нажатие любой клавиши 


@тереас: 

поу АН, 1 ; проверяем наличие символа в буфере клавиатуры 
10 166 ; вызываем прерывание 

)3= @гереае $; если нет, повторяем 

поУу АХ, 0 ; читаем символ 

106 168 ; вызываем прерывание 

$е5{ АБ, АБ ; если получен расширенный код 

32 ВЕАШР_ЕХТ ; обрабатываем его в другом месте 
поу АН, 1 ; передаем символ в модем 

оу ОХ, 1 ; порт С0М2 

176 146 ; вызываем прерывание 


17.2.2.3. Функция 02} 
Данная функция позволяет прочитать символ из последовательного порта. 
Использование: 

В регистр Ан следует поместить код функции о28. 
2. В ох записывается порядковый номер последовательного порта (0—3). 
3. Вызывается прерывание В1ОЗ 1пе 14ъ. 


Выход: 


После выполнения функции в регистр дн будет записано состояние порта 
(см. табл. 17.3), в АЬ — код прочитанного символа. Простой пример исполь- 
зования данной функции показан в листинге 17.5. 
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; инициализируем порт СОМ 
са11 101 СОМ 1 


поу АН, 2 ; читаем байт из порта 
пох ОХ, 0 ; порт СОМ 
116 140 ; вызываем прерывание 


фезЕ АН, АН ; если данные получены 
]2 ООПТ 5СВЕЕМ; выводим на дисплей 


17.2.2.4. Функция ОЗР 


Функция позволяет получить текущее состояние порта и подключенного 
к нему модема. 


Использование: 

В регистр Ан следует поместить код функции о3в. 
2. В ох записывается порядковый номер последовательного порта (0—3). 
3. Вызывается прерывание В1О$ зпё 14ъ. 


Выход: 

После выполнения функции в регистр Ан будет записано состояние порта 
(см. табл. 17.3), а в регистр АЪ — состояние модема (см. табл. 17.4). Пример 
использования данной функции представлен в листинге 17.6. 





`! Листинг 17.6. Получение состояния последовательного порта 


поУ АН, 3 ; получаем состояние 
поу ОХ, 2 ; порт СОМ2 
зп 146 ; вызываем прерывание 


ТезЕ АН, 100006; если есть перерыв в передаче данных 
312 ЕВКОВ_НМО; передаем управление другому обработчику 
тезе АН, 106 ; если обнаружена ошибка переполнения 

312 ЕВКОВ_НМО; передаем управление другому обработчику 
фезЕ АН, 015 ; если данные не готовы 

312 ЕВВОВ НМО; передаем управление другому обработчику 


На этом можно завершить рассмотрение функций ВТОЗ и перейти к непо- 
средственному программированию портов. 


17.3. Использование портов 


Как мы уже знаем, стандартное количество параллельных портов ограниче- 
но тремя: ЕРТ1, ЕРТ2 и ЕРТЗ. Порты ввода-вывода распределены согласно 
табл. 17.5. 
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Таблица 17.5. Распределение параллельных портов ввода-вывода 


ЁРТ1 или ЕРТ2 ЕРТ2 или ЕРТЗ Описание порта 


378 В 278 Порт данных 
3795 2795 Порт состояния 


З7АВ 27АВ Порт управления 





Можно напрямую обращаться к этим портам или же получить их значения 
из области памяти ВОЗ (0040.:00085 и 0040.:000АВ). Рассмотрим порты 
ввода-вывода подробнее. 


Порт данных (3785 или 2785) служит для передачи данных между компьюте- 
ром и устройством (например, принтером) и доступен как для записи, так и 
для чтения. 


Порт состояния (379ъ или 2795) позволяет получить информацию о текущем 
состоянии подключенного устройства и доступен только для чтения. Его 
формат представлен в табл. 17.6. 


Таблица 17.6. Формат порта состояния 


Бит Описание 
0—2 — Не используются и должны быть установлены в 0 

3 Ошибка ввода-вывода (1 -— нет, 0 -- есть) 

4 Выбор принтера (1 — принтер доступен, 0 — принтер недоступен) 
5 Закончилась бумага (1 — нет бумаги, 0 — есть) 
6 


Подтверждение приема данных (0 — подтверждение есть, 1 — принтер 
не готов) 


7 Готовность принтера (1 — принтер не занят, 0 — принтер занят) 


Порт управления (З7Ан или 27Ан) позволяет инициализировать принтер и 
установить различные параметры работы. Формат этого порта показан в 
табл. 17.7. 


Таблица 17.7. Формат порта управления 





Бит Описание 





0 Состояние линии ЗТНОВЕ (1 — можно передать данные на принтер, 
0 — стандартное состояние) 
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Таблица 17.7 (окончание) 
Бит Описание 


1 Использование автоматического перевода строки |Ё (Ап) после возврата 
каретки СВ (рь): 1 — использовать 


2 Инициализация порта принтера (0 — выполнить начальную инициализацию) 
Выбор принтера (1 — принтер доступен, 0 — принтер недоступен) 
Использовать прерывание от принтера (1 — использовать, 0 — нет) 


5—7 — Не используются и должны быть установлены в 0 


А теперь рассмотрим практические примеры работы с параллельными пор- 
тами. Перед началом работы необходимо инициализировать порт, как это 
сделано в листинге 17.7. Кроме того, инициализацию нужно выполнить по- 
вторно, если произошла ошибка передачи данных. 


Листинг 17.7. Инициализация параллельного порта 





поу ОХ, З7ТАБ ; порт управления 1РТ1 или ПРТ2 

поу АБ, ОСр ; подготавливаем порт к работе 

оцЕ ОХ, АЁ ; записываем значение в порт 

; необходима небольшая задержка (не менее 0,5 мкс) 
шоу СХ, 1500 ; начальное значение счетчика 

@ае1ау: 

1оор @4е1ау ; повтор 

поу АБ, 08№ ; инициализация порта 

ое ОХ, АБ ; записываем значение в порт 


Аналогичный пример для С+- показан в листинге 17.8. 





Листинг 17.8. Инициализация параллельного порта в С++ 


// пишем функцию инициализации 
У01А ТЮ1ЕЬРТ ( ипз19пеЯ 116 Роге) 


{ 
оЧЕРоге ( Роге, 0х0С, 1}; // подготавливаем порт к работе 
$1еер (1); // небольшая задержка 
ОЧЕРОГе ( Роге, 0х08, 1); // инициализируем порт 

} 


// используем функцию для инициализации порта 27АБ 
То1ЕГРТ ( 0х27А); 
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Для проверки готовности принтера можно использовать код в листинге 17.9. 


хог АБ, АЦ ; обнуляем порт 

поу ОХ, 3791 ; порт состояния ЬРТТ или ПРТ2 
101 АБ, ОХ ; читаем байт из порта 

фезЕ АГ, 100006; проверяем 4 бит 

= № ОМШМЕ; принтер не подключен 


Аналогичный пример для С++ показан в листинге 17.10. 





: Листинг 17.10. П оверка готовности порта РТ в С++ 





// пишем функцию проверки подключения принтера 
Ьоо1 ТзВеаау ГРТ ( ипз1дпеЯ 11 Рок®) 


{ 
ОИОВО амВези1{ = 0; 
1пРоге ( Роге, &ЧмВези]1®, 1); // читаем байт из порта 
1Е ( ( Чивеза1Е & 0х10) == 0х01) 
кебагпт гие; // принтер подключен 
хебагп Ёа15е; // принтер не подключен 
} 


Для того чтобы послать на принтер байт данных, необходимо выполнить 
следующие действия: 


1. Послать байт данных в порт данных. 


2. Установить бит 0 управляющего порта в 0, а после неболышой паузы — 
в [. 


3. После этого следует ожидать готовности принтера к приему следующего 
байта данных. Для этого постоянно опрашивается бит 7 в регистре стату- 
са. Когда он будет установлен в |, можно переходить к пункту 2. 


Пример записи данных в порт принтера показан в листинге 17.11. 


Меззаде 4 'ТезЕ11д оЁ Пе ре1пкег$' 

; общий код программы 

поу ВХ оЕЁзее Меззаде; указатель на строку символов 
; проверяем готовность порта 

поУу СХ, 5000 ; значение счетчика 

поУ ОХ, 3791 ; порт состояния 
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@иа1е ТРТ: 

11 АБ, ОХ ; читаем байт из порта 

фезе АБ, 801 ; проверяем бит 7 

1оорпе @ма1{ ГРТ; если бит 7 равен 1, повторяем 
по ОХ, 3781 ; порт данных 


@Ча1ее: 
поу АБ. [ВХ] ; копируем символ в АЁЬ 
оцЕ ОХ, АБ ; записываем значение в порт 


поу ОХ, З7АН ; порт управления 

поу АБ, ОБА ; устанавливаем сигнал ЗТВОВЕ 

ое ОХ, АБ ; записываем значение в порт 

Аес АЁ ; сбрасываем сигнал $ЗТВОВЕ 

оп ОХ, АБ ; записываем значение в порт 

; проверяем готовность принтера к приему следующего символа 
ес ОХ ; порт состояния 

@т5Веаду: 

11 АБ, ОХ ; читаем байт из порта 

тезе АГ, 8 ; можем проверить ошибку 

]12 ЕВВОВ_НМО; передаем управление обработчику ошибок 
Еезе АТ, 801 ; проверяем бит 7 

32 @15ВеаЧ4у ; если принтер не готов, повторяем 

11с ВХ ; следующий символ 

Чес ПОХ ; порт данных 


Аналогичный пример для С++ показан в листинге 17.12. 


// пишем функцию для передачи байта на принтер 
106 беЕВуе ПРТ ( алз1апеЯ 116 ВазеРох®, ВУТЕ ЮБака) 
{ 
ОИОВО ЧмВезо1е = 0; 
17Е 1Таема1е = 5000; 
// проверяем готовность порта 
у211е ( -- 1Тнаема1* > 0) 
{ 
// читаем порт состояния 
1пРогЕ ( ВазеРог® + 1, &ЧмКеза1%, 1); 
1Е ( (4мВеза16 & 0х80) == 0х00) Бгеак; 
// закончилось время ожидания 
1Е ( 1Тымейа1{ < 1) гебаги 1; // вышло время ожидания 
} 
// записываем значение байта данных в порт 
очЕРоге ( ВазеРог®, ЮБафа, 1); 
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// устанавливаем сигнал 5ТВОВЕ 
очЕРогЕ ( ВазеРоге + 2, 0хОор, 1); 
// сбрасываем сигнал ЭТВОВЕ 
оцЕРогЕ { ВазеРогЕ +2, 0хОС, 1); 
// проверяем готовность принтера к приему следующего символа 
1ТилеМа1е = 10000; 
Ур11е ( -- 1Тлема1 > 0) 
{ 
// читаем порт состояния 
1аРоге ( ВазеРоге + 1, &ЧмВеза1&, 1); 
1Е { (@мвеза & 0х08) == 0х00) хебаки 2; // произошла ошибка 
1Е ( (Я9мВези1Е & 0х80) == 0х01) Бгеак; 
// закончилось время ожидания 
1Е ( 1ТииеМа1е < 1) гебагп 1; // вышло время ожидания 
} 


гебгагп 0; 


Работа с последовательным портом лишь немного сложнее параллельного. 
Стандартное распределение портов показано в табл. 17.8. 


Таблица 17.8. Распределения последовательных портов ввода-вывода 


Номер порта Регистры ввода-вывода 
СОМ1 ЗЕВН— ЗЕЕВ 
СОМ? 2Е8В-—2РЕВ 
СОМЗ ЗЕ8Н-— ЗЕЕЪ 
СОМ4 2Е8}-—2ЕЁВ 





Из таблицы видно, что для доступа к последовательному порту выделены 
10 регистров, каждый из ‘которых имеет свое назначение. Все регистры 
имеют размер 8 бит. 


Регистр ЗЕ8н выполняет несколько задач и доступен для чтения и записи. 
Если бит 7 в регистре управления (ЗЕВН) равен 0, то через зЕ8н можно чи- 
тать и записывать данные. Если бит 7 в регистре управления (ЗЕВЬ) равен 1, 
то регистр зЗЕ8ь обрабатывает младший байт делителя частоты для скорости 
передачи данных. 


Регистр ЗЕЭЪ также выполняет несколько задач и доступен для чтения и 
записи. Если бит 7 в регистре управления (ЗЕВь) равен 0, то регистр ЗЕЭь 
управляет прерыванием (табл. 17.9). Если бит 7 в регистре управления (ЗЕВЬ) 
равен 1, То ЗЕЭь обрабатывает старший байт делителя частоты для скорости 
передачи данных. 
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Таблица 17.9. Формат регистра ЗЕЭЬ в режиме управления прерыванием 


Бит Описание 


0 Состояние сигнала прерывания при наличии входных данных (1 — включен, 
0 — выключен) 


1 Состояние сигнала прерывания при опустошении выходного буфера 
(1 — включен, 0 — выключен) 


2 Состояние сигнала прерывания при появлении ошибки или перерыва 
в передаче данных (1 — включен, 0 — выключен) 


З Состояние сигнала прерывания при изменении состояния модема 
(1 — включен, 0 — выключен) 


4—7 — Не используются и должны быть установлены в 0 


Регистр ЗЕАн доступен для чтения и записи. Он позволяет определить при- 
чину прерывания в режиме чтения (Табл. 17.10). В режиме записи регистр 
управляет режимом Е!РО (табл. 17.11). 


Таблица 17.10. Формат регистра згэЭр в режиме чтения 
Бит Описание 


0 Состояние прерывания (1 — нет прерывания, 0 — есть прерывание) 


1—2 — Причина прерывания (005 — изменение состояния модема, 015 — опустошен 
буфер передачи, 105 — получены данные, 115 — произошла ошибка или пе- 
рерыв в передаче данных) 


3 Закончилось время ожидания (тайм-аут} для приемника Е!РО 
4—5 — Не используются и должны быть установлены в 0 


6—7 Наличие РРО (11ь — присутствует, 005 — отсутствует) 


Таблица 17.11. Формат регистра ЗЕЭН в режиме записи 


Бит Описание 


0 Управление работой режима Е!РО (1 — включен, 0 — выключен) 
1 Очистка приемника Е!РО (1 — очистить) 
2 Очистка передатчика НЕО (1 — очистить) 


3—5 — Не используются и должны быть установлены в 0 


6—7 — Порог срабатывания для чтения данных (005 — 1 байт, 01ь — 4 байта, 
105 — 8 байт, 115 — 14 байт} 
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Регистр ЗЕВь доступен для чтения и записи. Он предназначен для управле- 
ния линией связи. Формат регистра показан в табл. 17.12. 


Таблица 17.12. Формат регистра управления 


Описание 


Длина данных (005 — 5 бит, о1ь — 6 бит, 105 — 7 бит, 11ь — 8 бит) 
Количество стоповых битов (0 -- 1 бит, 1 — 2 бита} 
Бит четности (000 — нет, 001ь — нечетный, 011ь — четный) 


Состояние перерыва передачи, при котором порт выдает нули 
(1 — включить, 0 — выключить} 


Управление делителем частоты для выбора скорости передачи данных 
(1 — установить значение делителя частоты через регистры зЕзп и ЗЕ) 


Регистр згсь доступен для чтения и записи. Он служит для управления ра- 
ботой модема. Формат регистра показан в табл. 17.13. 


Таблица 17.13. Формат регистра управления модемом 


Описание 


Управление линией ОТВ 


Управление линией ВТ$ 
Управление линией ОПТ1 (0) 
Управление линией ООТ2 (1) 


Самотестирование модема (1 — включить), при котором выход 
замыкается на вход 


Не используются и должны быть установлены в 0 


Регистр зЕкОь доступен только для чтения. Он позволяет получить текущее 
состояние линии связи. Формат регистра был показан в табл. 17.3. 


Регистр ЗЕЕВ доступен только для чтения. Он позволяет получить текущее 
состояние модема. Формат регистра был показан в табл. 17.4. 


Регистр ЗЕСв доступен для чтения и записи. Он является резервным и не 
используется. 


Перед началом работы нужно инициализировать последовательный порт. 
Для этого следует вначале установить бит 7 в 1 для регистра згвь, а затем 
записать желаемую скорость передачи (старший и младший байты) в реги- 
стры ЗЕЗв и ЗЕЭН. После этого в регистр ЗЕВЬ можно записать режим работы 
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линии, обнулив бит 7. Затем в регистр ЗЕЭн надо записать 0, если прерыва- 
ния не будут использованы, или установить биты 0--3 в соответствии с тре- 
буемыми прерываниями. Возможные значения для скорости передачи дан- 
ных представлены в табл. 17.14. 


Таблица 17.14. Коды значений для установки 
скорости передачи данных 























Код значения 





Скорость, бод 


110 


01 300 
оон 600 
ов 1 200 
оон 2 400 
оон 3 600 
оон 4 800 
оон 7 200 
008 9 600 
ов 19 200 
оон 38 400 
о0п 57 600 

115 200 


В листинге 17.13 показано, как выполняется инициализация последователь- 
ного порта без использования прерываний. 


Листинг 17.13. Инициализация порта СОМ1 





То СОМ! ргос 

поу АГ, В80Н ; устанавливаем бит 7 в 1 

поу ПОХ, ЗЕВЬ ; регистр управления линией 

оц ОХ, АБ ; записываем данные в порт 

; устанавливаем скорость передачи данных 9 600 бод 

поу ОХ, ЗЕВН ; порт для установки младшего байта делителя 
поу АЁ, 005 ; младший байт делителя 

опЕ ОХ, АБ ; записываем данные в порт 
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поу АЁЬ, ОСЬ ; старший байт делителя 

поу ОХ, ЗЕЭН ; порт для установки старшего байта делителя 
сие ОХ, АБ ; записываем данные в порт 

; настраиваем регистр управления линией ЗЕВЬ 

поу ОХ, ЗЕВВ ; порт управления линией 

поу АБ, 000000115; 8 бит, 1 стоповый бит, без четности 
оцЕ ОХ, АБ ; записываем данные в порт 

; настраиваем регистр управления модемом ЗЕСП 

поу ОХ, ЗЕСЬ ; порт управления линией 

шоу АБ, 000010115; ОТА, ВТ5, О0Т1, ООТ2 

оц ОХ, АБ ; записываем данные в порт 

; настраиваем регистр управления прерываниями ЗРЭВ 

шоу ОХ, ЗЕЭр ; порт ЗЕЭВ 

поу АБ, 0 ; запрещаем все прерывания 

оце ОХ, АБ ; записываем данные в порт 

теё 

1116 СОМ1 епар 


Аналогичный пример для С+- показан в листинге 17.14. 


// пишем функцию инициализации последовательного порта 

уо1а 1016 СОМ ( ап$191е4 11 ВазеРог®) 

{ 
// устанавливаем бит 7 в 1 в регистре управления линией 
опЕРогЕ ( ВазеРоге + 3, 0х80, 1); 
// устанавливаем скорость передачи данных 9 600 бод 
ОпЕРогЕ ( ВазеРогЕ, 0х00, 1); // младший байт делителя 
ОЦЕРОГЕ ( ВазеРог®е + 1, 0х0С, 1); // старший байт делителя 
// настраиваем регистр управления линией 
// 8 бит, 1 стоповый бит, без четности 
оцЕРогеЕ ( ВазеРокЕ + 3, 0х03, 1); 
// настраиваем регистр управления модемом 
// ОТВ, ВТЗ, 00Т1, ООТ2 
опЕРоге ( ВазеРоге + 4, ОхОоВ, 1); 
// настраиваем регистр управления прерываниями 
оцЕРОГЕ ( ВазеРог® + 1, 0х00, 1); // запрещаем все прерывания 


Для проверки текущего состояния линии можно использовать код, пред- 
ставленный в листинге 17.15. 
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; проверка состояния линии перед записью данных в порт 
ТзВеаа Мг1{е СОМ ргос 

хог АБ, АБ ; обнуляем АБ 

иоу ОХ, ЗЕОБ ; порт состояния линии 

12 А, ОХ ; читаем байт состояния из порта 

тезЕ АТ, 108 ; если бит 5 установлен в 1 

12 МО МВТТЕ ; передаем управление процедуре ожидания 
гее ; иначе выходим 

Т5ВеаЯ Иг16е СОМ епар 

; проверка состояния линии перед чтением данных из порта 
Т5ВеаЯ_ВеаЯ_СОМ ргос 

хог АБ, АБ ; обнуляем АБ 

поу ОХ, ЗЕШЬ ; порт состояния линии 

12 АБ, ОХ ; читаем байт состояния из порта 

фезЕ АТ, 106 ; если бит 1 установлен в 1 

12 № ВЕАШЬ ; передаем управление процедуре чтения данных из порта 
ге ; иначе выходим 

ТзВеаЯ ВеаЯ СОМ епар 


Аналогичный пример обработки состояния для С++ показан в листин- 
ге 17.16. 


Листинг 17.16. Проверка состояния последовательного порта в С++ 


// проверка состояния линии перед записью данных в порт 
роо1 ТзВеа@Я Мг1ее СОМ ( опз19пеЯ 1пЕ ВазеРог®) 


{ 
ОМОВО ФиВези1е = 0; 
1поРок® ( ВазеРок® + 5, &амВезо1%, 1); 
1ЁЕ ( ( Чмвеза1 & 0х10) == 0х01) 
театр Ёа]зе; // линия занята 
тееигп Егие; 
} 


// проверка состояния линии перед чтением данных из порта 
Боо1? ТзВеаа ВеаЯ_ СОМ ( ипз1атеЯ 11е ВазеРог®) 
{ 

ОИОВО 4мВезо1 = 0; 

1оРогЕ ( ВазеРоге + 5, &мВезо1е, 1); 

1Е ( ( ЧЗмвВеза1 & 0х02) == 0х01) 

героагр Ёа]зе; // в линии остались непрочитанные данные 
тевагп гие; 
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Теперь, когда последовательный порт готов к работе, можно записать в него 
данные (листинг 17.17). 


Листинг 17.17. Запись байта данных в последовательный порт СОМ1 





; байт для данных 

рафта_Вусе аЮ 55 

; общий код программы 

; пишем процедуру для передачи байта данных в порт СОМ1 
ЗепаВуЕе СОМ ргос 

поу ОХ, ЗЕВЬ ; порт данных 

поу АГ, Рафа Вуфе; копируем байт данных 

ОЕ ОХ, АБ ; записываем байт в порт 

гее 

ЗепаВусе_ СОМ епар 


В рассмотренном примере опущены проверки состояния. Если вы исполь- 
зуете прерывания, проверять состояние линии не обязательно, но в своем 
обработчике необходимо контролировать регистр состояния линии и моде- 
ма. 


Аналогичный пример посылки в порт байта для С+-+ показан в листин- 
ге 17.18. 


: Листинг 17.18. Запись байта данных в последовательный порт для С++ 


// пишем функцию для записи байта в последовательный порт 
уса ЗепаВуее СОМ ( ип51д9пеЯ 1пе ВазеРоге, спак* Чака) 
{ 

// записываем байт в порт 

опЕРогЕ ( ВазеРоге, ( ОМОВО) Чафа, 1); 


Пример чтения байта из последовательного порта представлен в листин- 
ге 17.19. 





; буфер для данных 

Раса Вузе а ? 

; общий код программы 

; пишем процедуру для чтения байта данных из порта СОМ1 
ВеааВуее СОМ ркос 

поу ОХ, ЗЕЗВ ; порт данных 
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11 АБ, ОХ ; читаем байт из порта 
поу Бафа_Вубе, АГ; копируем байт данных 
тее 

ВеааВусе СОМ епар 


Аналогичный пример чтения байта для С++ показан в листинге 17.20. 


Листинг 17.20. Чтение байта данных из последовательного порта в С++ 





// пишем функцию для чтения байта из последовательного порта 
ВУТЕ ВеаЯ9ВуЕе СОМ ( ипз1дпеЯ 1пЕ ВазеРог®) 
{ 

ОМОВО ЧмВеза1е = 0; 

// читаем байт из порта 

1пРогЕ ( ВазеРоге, &Ч9мВезо1&, 1); 

тебогп ( ВУТЕ) ЧмВезо16; 


На этом я хотел бы завершить программирование портов ввода-вывода и 
немного рассказать о поддержке последовательных и параллельных портов 
в интерфейсе У\/т32 АР]. 


17.4. Использование \!т32 АР 


Работа с ЕРТ- и СОМ-портами в \т4о\5 упрощена до минимума. Чтобы 
инициализировать порт, достаточно вызвать функцию СгеафеЕ11е с соответ- 
ствующими аргументами. После этого можно писать и читать данные в порт 
посредством стандартных функций Иг1+еЕ11е И ВеаЧЕ11е. Кроме того, для 
настройки портов и последующего управления ими предназначен целый ряд 
дополнительных функций. Рассмотрим основные моменты программирова- 
ния портов подробнее. 


Перед началом работы необходимо открыть порт и настроить его на требуе- 
мый режим работы (для СОМ). В листинге 17.21 показано, как можно это 
сделать. 





Листинг 17,21. Начальная инициализация последовательного порта СОМ1 


41ос1тоде <и1о4ом$.Н> 

// объявляем структуру для конфигурации последовательного порта 
ОСВ ась; 

2егоМетоку ( &асЬ, з1теоЕЁ ( ПСВ)); 

// дескриптор порта 

НАМОЬЕ НСом_1 = М; 
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// пишем функцию инициализации порта СОМ1 
Боо1 1п1Е СОМТ () 
{ 
// открываем порт СОМТ ( для СОМ2 "СОМ2", для БРТТ "ЁБРТ1" ит. д.) 
ЮСом_1 = СгеафеЕ11е ( "СОМ1", СЕМЕВТС ВЕАШО | СЕМЕВТС МВТТЕ, 0, МОШ,, 
ОРЕМ_ЕХТЗТТМС, ЕТЬЕ_ЕТЪАС ОУЕВЬАРРЕО, МОТ); 
1Е ( ПСом 1 == ТМУАШТО НАМОЬЕ УАГОЕ} // если порт не удалось открыть 
тебагп Ёа1зе; // выходим из функции 
// если порт успешно открыт, получаем его состояние 
1Е ( '!СееСоптбфаее ( ПСом 1, &ась)) 
{ 
// если не удалось получить статус порта, выходим из функции 
С]озеНап91е ( НСом_1); 
текакп Еа1зе; // выходим из функции 
} 
// настраиваем параметры порта 
ась.ВацаВасе = СВК_19200; // скорость передачи 19 200 бод 
ась.ВуЕе512е = 8; // размер байта данных 
ась.5ЕорВ1ез = ОМЕЗТОРВТТ; // один стоповый бит 
Ясь.Раг1фу = МОРАТТТУ; // контроля четности нет 


и 


// сохраняем новые параметры конфигурации для порта 
1Е ( !ЗеЕСопабфаке ( Сом 1, &асЪ)) 

{ 

// если не удалось настроить порт, выходим из функции 
С1озеНапЯ1е ( ПСом 1); 

тебкокп Еа15е; // выходим из функции 

} 


тебагп Егце; 


Теперь, когда наш порт открыт и сконфигурирован для работы, нужно на- 
строить обработку сигналов ОЗК и СТ$. Пример кода для активизации уве- 
домлений для последовательного порта показан в листинге 17.22. 


Листинг 17.22. Настройка уведомляющих событий для сигналов О$К и СТ$ 


// объявляем структуру для асинхронного ввода-вывода данных 
// и помещаем ее в глобальную область видимости 

ОУЕВТАРРЕО охег; 

2егоМетогу ( &оуег, $1теоЕ ( ОУЕВЬАРРЕО)); 

// пишем функцию настройки событий 

роот ЗеЕЕхепесом ()} 
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// настраиваем мониторинг за определенными событиями порта 
1Е ( 'ЗеЕСошиМазк ( Сом 1, ЕМ_О5В | Е\ СТЗ)) 

{ 

// если не удалось настроить порт, выходим из функции 
С1озеНапа1е ( ВСом 1); 

гесакп Еа1зе; // выходим из функции 

} 
// создаем объект события 
отег.ПЕхепЕ = СкеабеЕхепе ( МОТ, КАБЬЗЕ, РКАШЬЗЕ, МО); 
1Е ( !охег.ВЕхепе) 

{ 

// если не удалось создать событие, выходим из функции 
С1озеНапа1е ( ВСом_1); 

гекагп Еа1зе; // выходим из функции 

} 


тебагп Егае; 


На данный момент вся начальная подготовка для работы с портом законче- 
на. Осталось только написать функции чтения и записи данных и функцию 
управления для последовательного порта. Примеры функций чтения и запи- 
си показаны в листинге 17.23. 


Листинг 17.23. Функции чтения и записи для работы с последовательным 
: портом 
// функция чтения одного байта данных 
ВУТЕ КеааВуеесом () 
{ 

ВУТЕ геаа = 0; 

ОМОВО омВусеВеаа = 0; 

ао 

{ // читаем байт из порта 

1Е ( !Веааг11е ( ПСом_1, &геаа, э1теоЕ ( ВУТЕ), вамВужевеаа, 
МОБ) } 
хебагп 0; 

} эре ( !амВубеВеаа); 
тебагп геаЯ; // возвращаем прочитанный байт 
) 
// функция чтения массива данных 
ОМОКО ВеаЯРафа_СОМ ( уо14* Баба, чаз19щеа 1пе оМатВусез) 
{ 

РИОВО амВуфезВеаа = 0; 
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1Е ( 'ВеааЕ11е ( ВСом_1, Рафа, иМошВукез, амВусезВеая, М011,)) 
хебогр ЧиВубезКеаЯ; // сколько удалось прочитать 

хебахп амВубезВеаЯ; // возвращаем полное число прочитанных байтов 
} 
// функция для записи одного байта 
Боо1 Му1еЕеВусесом ( ВУТЕ ЬВуке) 
{ 

ВУТЕ име = 0; 

ОМОВр амВукемтаее = 0; 

1Е ( 'МгстбеРг11е ( ВСом_1, &мг10е, з1теоЕ ( ВУТЕ), &дмВусейг1е, 

мо) } 
гебокп Еа15е; 

тебакп 6гие; 
} 
// функция для записи массива данных 
ОИОВО Их1ЕерафаСОМ ( уо14* Баба, ипз1атеа 1пе иМоиВубез) 
{ 

БМОВО амВусезИг1{е = 0; 

1Е ( 'Мкеге ( ПСом_1, Рафа, ичМатВубез, &амВубемк1ее, 

МОБ) 
гебоги амВусезИк1ее; // сколько удалось записать 
гебакр ЧиВубезМг16е; // возвращаем полное число записанных байтов 


Теперь пишем общую функцию для работы с портом (листинг 17.24). 





Листинг 17.24. Общая функция для работы с последовательным портом 


// добавляем в глобальную область данных значение для выделения сигнала 
ОМОВО м519та1; 
$01 Сепехга1СоМм () 
{ 
// проверяем сигнал в линии 
1Е ( Иа1ЕСотиЕхете ( ПСом_1, &@519па1, &оуег)) 
{ 
1Е ( 9м319па1 & ЕУ 058) // данные готовы для чтения 
{ 
// читаем байт из порта 
ВУТЕ Чака = ВеаЧВукесом (); 
// сохраняем полученный байт куда-либо 
} 


1Е ( 9319ра1 & ЕУ СТ$) // можно писать данные в порт 
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// передаем извне байт и пишем его в порт 
Мг1февВусесом ( муВу%е); 


} 
// после завершения работы следует вызвать функцию очистки ресурсов 


01а С1озесом () 


{ 
1Е ( оуег.БЕхепь) 


{ 
С1озеНапа1е ( оуег.ВЕуеп®); // закрываем объект события 


оуег.ВЕхепе = М0; 


} 
1Е ( БСом 1) 


{ 
С1озеНапЧ1е ( ВСом_1); // закрываем порт СОМ1 


Сом = МОБ; 


Вот в принципе и все. Дополнительные возможности, предоставляемые ин- 
терфейсом \!т32 АР], вы сможете добавить уже самостоятельно. 
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ГЛАВА 18 


Элементы управления 


Практически ни одна современная программа сегодня не обходится без ин- 
терактивного графического интерфейса (СУП, который, в свою очередь, 
базируется на многообразии элементов управления, как стандартных, так и 
пользовательских. Именно по внешнему виду пользователи "встречают" и 
делают первые выводы о программе. Поэтому для разработчика вопрос 
оформления оболочки приложения должен стоять не на последнем месте. 
Особенно это важно при создании игровых и обучающих программ, эн- 
циклопедий и детских учебников. Существует даже отдельная профессия 
дизайнера программ, который занимается только внешним оформлением 
приложения, но поскольку наша книга посвящена в первую очередь про- 
граммированию, мы рассмотрим вопросы создания и использования все- 
возможных элементов управления. 


Как вы знаете, в оболочку М15ца! С+- (\У!5а! С++ .МЕТ) входит визуальный 
редактор ресурсов, с помощью которого и создается "лицо” будущей про- 
граммы. К сожалению, его возможности довольно ограничены по сравне- 
нию, например, с У15иа| Ваяс или \У!виа| С#. В нем полностью отсутствуют 
такие полезные мелочи, как управление шрифтом, цветом, загрузка карти- 
нок и динамическое изменение формы элемента управления. Все это при- 
ходится программировать вручную, на что уходит половина всего времени, 
затраченного на разработку программы. Этот момент, кстати, отпугивает 
многих начинающих программистов, предпочитающих более простой путь 
использования возможностей \!виа| Ваус или У!5иа! С#. Да и разработчики 
крупных проектов для создания интерфейса применяют упрошенные языки 
программирования по причине экономии времени. Однако есть и очень 
серьезный недостаток такого подхода, выраженный в серьезном увеличении 
дистрибутива программы. Поэтому выбор остается за разработчиком, а я 
постараюсь убедить вас в том, что в \У!5иа| С++ можно так же легко рабо- 
тать с элементами управления, как и в других языках. Поверьте мне на сло- 
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во, НИ один самый мощный редактор ресурсов не дает и половины той ши- 
роты и функциональности, которую предоставляет прямое программирова- 
ние \!т32 АР]. 


18.1. Стандартные элементы управления 


Сначала мы разберем стандартные, а затем дополнительные элементы 
управления. Для приводимых в книге примеров будут использованы как 
возможности программного интерфейса \т32 АРТ, так и библиотеки клас- 
сов от Мисгозой (МЕС). 


К стандартным элементам управления относятся: 

1. Кнопка (ВиИоп). 

2. Раскрывающийся список (СотБо Вох). 

3. Поле редактирования (Е@й Вох). 

4. Список (115 Вох). 

5. Поле редактирования с расширенными возможностями (св ЕЧи). 
6. Линейка прокрутки (ЗсгоЙ Ваг). 

7. Статический элемент (З4айс Техб. 

Рассмотрим работу с этими элементами управления подробнее. 


18.1.1. Кнопка 


Кнопка является основным средством интерактивного взаимодействия с 
пользователем программы. Мы изучим основные моменты программирова- 
ния кнопки: изменение шрифта, цвета и внешнего вида. 


Для управления шрифтом нам понадобится структура тосгомт, определяющая 
параметры шрифта, и функция создания нового шрифта Сгеакегопетпа1гесе. 
В листинге 18.1 показан пример установки нового шрифта для кнопки. 


// пишем функцию замены шрифта 
Ьоо1 ЗеЕёКопеВиееоп ( НИМО 0019, 11 1ВаёбоптТрО, 10 1Не1аре, сваг* Еопё, 
Боо1 Во14, Боо1 Т%а11с, Боо1 Опаек11те) 


ТОСЕОМТ 1Е; 

НЕОМТ БЕРопЕ = МО; // дескриптор шрифта 

// обязательно обнуляем структуру перед использованием 
петзее ( &1Ё, 0, з12еоЁ { РОСЕОМТ)); 
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// высота шрифта 
1Е ( 1Нелове > 6) 
1Е.1ЕНезане = 1Незаве; 
е1зе 
1Е.1ЕНелаье = 8; 
// имя похожего шрифта 
1Е ( ]1з6:у1ер ( ЕопЕ) > 4} 156хсру ( 1Е.1ЕРасеМаше, Ёор®); 
// жирный шрифт 


1ЁЕ ( Во]1а)} 

1Е.1ЕМетаре = РЕМ ВОЬ; 
е1зе 

1Е.1Е\етаре = ЕМ_МОВМАГ; 


// наклон 

1Е ( 1Та11с) 1Е. 1Е16а11с = &тгае; 

// подчеркивание 

1Е ( Опдег пе) 

1Е.1ЕОпаег]1пе = &гае; 

// создаем шрифт 

БЕопЕ = СгеабеЕопЕТпа1тесе ( &1Е); 

1Е ( ВЕопЕ == МОБ) // не удалось создать новый шрифт 

гебогп Еа1$е; 
// устанавливаем новый шрифт 
Зеп9р191етМеззаде ( №019, 1Виопто, ММ ЗЕТЕОМТ, 
( ИРАВАМ) ВЕопе, 0); 

// освобождаем ресурсы системы 

Ре1еееоб)есе ( ВЕопЕ); 

тесигп Егие; 
} 
// .. 
// применяем нашу функцию при инициализации диалогового окна 
сазе ММ ТМТТРТАГОС: 
{ 

ЗеёЕопЕВие оп ( ВИпар14, ТОС МУВОТТОМ, 12, "Аг1а1", Ехгае, Еа15е, 

Еа1зе}; 

} 


гебгагип (гие; 


Как видно из примера, мы использовали структуру ЪОСЕОМТ для создания 
шрифта с помощью функции Сгеабегоре1пта1хесе. После этого мы послали 
сообщение им ЗЕТЕОМТ для созданной в редакторе ресурсов кнопки 
(тос мувоттом). Функцию изменения шрифта можно вызывать в любом мес- 
те программы, когда требуется заменить шрифт. Структура ъобЕомтТ имеет 
много дополнительных параметров, позволяющих создать собственный, ни 
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на что не похожий шрифт, но в большинстве случаев вполне хватает стан- 
дартных. Кроме того, при вызове функции зееЕопеВиееоп После инициали- 
зации диалога желательно вызвать функцию обновления Ордафей1пАом ДЛЯ 
кнопки. Чтобы освободить ресурсы системы, следует вызвать функцию 
Пе1есеор]ес+. 


Для изменения шрифта средствами библиотеки МЕС можно использовать 
код из листинга 18.2. Функция Ое1етеОБ]есе здесь не нужна, поскольку ос- 
вобождением ресурсов занимается класс СЕопе. 


// определяем класс работы со шрифтами и структуру БОСЕОМТ 
СКопЕ ш_Еопе; 

ТОСЕОМТ 1; 

петазее ( &1ЕЁ, 0, з17теоЁ ( ТОСРОМТ)); 

// заполняем структуру данными 

1Е.1ЕНелаве = 14; // высота шрифта 

1Е.1Е\е1обе = ЕЯ ВОГО; // жирный шрифт 

15Егсру (1Е.1ЕРасемаме, "Сагапоп Я"); // имя похожего шрифта 
// создаем новый шрифт 

п_Еопе.СкеабеРопеТпЧ1кесь ( &1Е); 

// устанавливаем созданный шрифт для кнопки ТОС МУВОТТОМ 
сеЕ019ТЕет ( ТОС МУВОТТОМ) ->5еЕ Гоп ( ва Еопе); 

// или таким способом, где м ВаЕбоп указывает на класс СВаееоп 
п Виссоп.5ееРопе ( &м Еопе, гие); 


Однако чтобы изменить цвет выводимого шрифта, нам придется воспользо- 
ваться другим способом. В листинге 18.3 показан пример кода для работы 
с цветом. 


Листинг 18.3. Изменение цвета текста на кнопке 


// главная функция диалогового ( или обычного) окна 
ВООЬ САБВАСК Мур1аРгос ( НММР Випар1а, ОТМТ пеззаде, МРАВАМ мРагат, 
ТРАВАМ ]Рагапм) 


// создаем дескриптор кисти 
зтас1с НВВО$Н ВВгазВ; 
// получаем дескриптор окна нашей кнопки 
НИМОЬ БМуВиссоп = беер19Теем ( пмоар1а, Трос МУВОТТОМ); 
// обработка сообщений 
5м1есН ( пеззаде} 

{ 

сазе ИМ ТМТТОТАТОС: // инициализация диалога 
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// создаем логическую кисть с системным цветом кнопки 
ЮВгизВ = Скеабе$о11АВгазь ( СеебузСо]ог ( СОБОК ВТМЕАСЕ) ); 
} 
гебигп Егие; 
сазе ИМ СТТСОЬОВВТМ: // обработка цвета для кнопки 
{ 
// выделяем сообщение для нашей кнопки 
1Е ( ( НММО} 1Ракам == БМуВа оп) 
{ 
// устанавливаем желаемый цвет текста и ( или) фона кнопки 
// цвет текста на кнопке, например синий 


ЗесТехЕСо1ог ( ( НОС) мРагаш, ВСВ ( 53, 57, 217)}; 
// цвет фона текста 
ЗеЕВКСо1от ( ( НОС) иРрРагаш, Сее5узСо]ог ( СОШОВ ВТМЕАСЕ)); 


текагп ( .ВЕЗОЬТ) ВВга$Ь; 


} 
тесаги $гице; 
сазе ММ ОЕЗТВОУ: // завершение работы программы 
{ 
// удаляем логическую кисть 
Ре]екеодю]есЕ ( ЮВгозВ); 
} 
гегигп &гие; 


} 
тесагп КАБЗЕ; 


Итак, чтобы изменить цвет текста на кнопке, в первую очередь следует соз- 
дать логическую кисть с помощью Функции Скеакебо11аВгазь. В качестве 
начального цвета можно задавать абсолютно ‘любой, но мы применили 
стандартный системный цвет кнопок (сотов_ВТМЕАСЕ). Для изменения цвета 
текста или фона кнопки требуется обработать системное сообщение 
ИМ СТЬСОтОВВтм. При этом параметр иРагам указывает на дескриптор контек- 
ста (нос), а 1Рагат — на дескриптор окна кнопки. Когда для нашей кнопки 
приходит сообщение им стьсоьоввтм, используем функцию зееТехеСо1ох длЯ 
установки цвета текста, а если нужно, то вызываем и функцию зесВкСо1ох 
для изменения цвета фона текста. Если вам необходимо использовать не- 
сколько цветов, на каждый следует создавать отдельную логическую кисть. 
После завершения работы с программой обязательно следует удалить соз- 
данную кисть, вызвав функцию ре1ефеОЮ3ес+. Макрос всв позволяет опреде- 
лить каждую из трех составляющих цвета: красную, синюю и зеленую. 
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В библиотеке МЕС изменение цвета реализуется не намного сложнее. 
В листинге 18.4 представлены отрывки из класса мус1азз диалогового окна 
(название класса может быть любым). 





Листинг 18.4. Изменение цвета текста на кнопке в МЕС 
// в объявлении класса ( МуС1азз.1) определяем указатель на класс СВгаз$В 
СВгазй* п рогВие®оп; 
// в реализации конструктора ( МуС1аз5.срр) создаем логическую кисть 
//{{АЕХ_РАТА_ТМТТ (ТпЕо$уз} 
п рогВаЕбоп = пем Сьгозр ( Н5_НОВТРОМТАТ, 
СеЕ5узСо1ок ( СОГОВ_МЕМО)); 
//}}АЕХ РАТА ТМТТ 
// добавляем в класс обработку сообщения ИМ СТЬСОШОВ 
// пишем реализацию для этого сообщения 
НВВО$Н МуС1аз$ :: ОпСё1Со1ог (СОС* ррС, Смпа* рипа, отМТ псСЕ1Со1ог) 
{ 
НВВО$Н ВЬг = СЯ91а1о9 :: ОпСЕ1Со1ох ( ррС, рИпа, пСЕ1Со1ог); 
эм1Еср ( пСе1Со1ог) 
{ 
сазе СТЬСОЬОВ_ВТМ: 
{ 
// проверяем дескриптор нашей кнопки 
1Е ( рипа->Сбеёр1асехк1 ТР () == ТРС МУВОТТОМ) 
{ 
// устанавливаем желаемый цвет 
РОС->5еЕТехЕСо1охк ( ВСВ ( 17, 12, 209)); 
// если нужно, то и цвет фона текста 
роС->5еЕВКСо]ог ( ВСВ ( 130, 100, 209)); 
// возвращаем кисть системе 
хебиато ( НВКО$Н) ( м рргВаебоп->СеЕбаЁеНапа1е ()); 


} 

ргеак; 
еРач1%: 
тебигп Вог; 


} 
// после завершения работы удаляем кисть 
Яе1ебке м ррогВаееоп; 


Вот и все премудрости. Теперь рассмотрим более сложную задачу, которая 
заключается в изменении цвета кнопки. Чтобы ее решить, нам понадобится 
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полностью взять на себя рисование и отображение кнопки. Для этого, 
в первую очередь, необходимо в редакторе ресурсов установить флажок 
Оупег @гаму, расположенный на вкладке 54е$ свойств кнопки. Затем следу- 
ет добавить в главную функцию диалогового окна обработку системного 
сообщения им ОВАИТТЕМ и подготовить несколько дополнительных функций 
для рисования кнопки. В листинге 18.5 показано, как это делается. 


Листинг 18.5. Изменение цвета кнопки 





// отрывок главной функции диалогового окна 
ВОО САБВАСК Мур1а9Ркос ( НИМР Випар1а, ОТМТ пеззаде, МРАВАМ зРагам, 
ЪРАКАМ ]1Рагам)} 


// указатель на структуру поддержки рисования 
.РОВАИТТЕМТВОСТ 1рОгам; 
// получаем дескриптор окна нашей кнопки 
НИМО БМувВие®оп = беЕр19Теет ( Вупа019, ТОС _МУВОТТОМ); 
// обработка сообщений 
зи1ЕсЬ ( пеззаде) 
{ 
сазе ММ ОВАИТТЕМ: 
{ 
// выделяем информацию для рисования элемента управления 
1ррбгам = ( .РРВАМТТЕМ$ТВОСТ) 1Рагап; 
// проверяем, кому передано сообщение 
1Е ( ЮМуваекоп == 1ррт15->БипатТеет) // если нам 
{ 
// рисуем кнопку 
ОТМТ избафе = 1рр1$->16Еещбеаее; // текущее состояние кнопки 
// сохраняем размеры кнопки 
ВЕСТ $12еГосиз, $512еВеп; 
СоруЁКес® ( &512еЕосиз, &1рогам->хсГ ем); 
СоруВесе ( &512еВЕп, &1ррогам->гстТЕет); 
// сохраняем текст кнопки 
срвахт ВЕпТехЕ [100]; 
СеЕИ1пАомТехЕ ( ЬМуВоаЕЕоп, ВЕпТехе, 100); 
// вычисляем размер прямоугольника фокуса 
$12егосиз.6ор += 4; 
$1хеРосиз .1еЕф += 4; 
$12еГосиз.г19НЕ -= 4; 
$12еРосиз.БоЕЕом -= 4; 
// рисуем кнопку и выводим на нее сохраненный текст 
Е11]ВесеВоевоп ( 1ррт5$->5рС, $512еВЕп, ВСВ ( 255, 255, 0}); 
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РгамВаЕ оп ( 1ррт$->Ь0С, $12хеВеЕп, 2); 
ЗеЕВиЕсопТехе (1рр15$->50С, $12еВёп, ВепТехЕ, ВСВ (0, 0, 0)); 
// обрабатываем различные состояния кнопки 
1Е ( обфафе & ОР$ РОСИ$) // кнопка в фокусе 
{ 
РгамЕосазВесЕ (1рот5$->50С, &512еГосиз); 
// если кнопка выбрана 
1Е ( иббафе & 005 ЗЕТЕСТЕР) 
{ 
Е11]ВесеВиееоп ( 1ротТ5$->8рС, 51хеВер, 
ВСВ ( 255, 255, 0)); 
РгамВоЕЕоп ( 1р0т5->5рС, $1хеВЕп, 2); 
ЗеЕВоееопТехЕе ( 1рр1$->50С, $12еВеп, ВеаТехе, 
ВСВ (0, 0, 0)); 
ПгамРосазВесе ( 1роТ$->50С, &51хеГосиз); 
} 
} 
е1зе 1Е ( З6абе & 0Р$ РТЗАВЬЕР} // кнопка не активна 


{ 
// обрабатываем, если нужно 


} 


Ьгеак; 


} 
тегагп РГАТЗЕ; 


Итак, мы получаем сообщение им РВАИТТЕМ для нашей кнопки. После этого 
сохраняем текущее состояние кнопки (нажата, в фокусе и т. п.) и ее разме- 
ры. Далее с помощью дополнительных функций рисуем и выводим кнопку 
на экран. Теперь остается только обработать различные состояния кнопки, 
и задача решена. В данном примере обрабатывается только момент нажатия 
и получение фокуса нашей кнопки. В листинге 18.6 представлена реализа- 
ция функций рисования. 





Листинг 18.6. Функции рисования стандартной кнопки 


// функция заполнения указанного прямоугольника цветом 
уо1а Е111ВесЕеВиЕе®оп ( НОС ЮЬС, ВЕСТ гесе, СОШОВВЕЕ с]1г) 
{ 

// создаем сплошную кисть указанного цвета 

НВВОЗН РВгизй = Сгеаке5о11АВгазВ ( с1т); 
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// заполняем прямоугольник выбранным цветом кисти 
Р111Весе ( ВОС, &гесё, ПВгаз|); 
} 
// функция для создания кнопки 
уо1А ОгамВаебоп ( НОС ВОС, ВЕСТ гесф, 1пЕ Вогаег) 
{ 
106 1, ра1, з1хеВта; 
СОБОВВЕЕ тр, Бат, с1т1, с1г2; 
// определяем знак рамки 
1Е ( Вогаек < 0) 
312еВга = -Вог4ег; // внутрь 
е1зе 
31геВт4 = Вог4ег; // наружу 
// рисуем кнопку 
Бог (1 = 0; 1 < э1хеВуа; 1 += 1) 
{ 
// создаем палитру из трех основных цветов 
рат = 255 / (1+2); 
с1:1 = РАТЕТТЕВСВ ( ра1, ра1, ра1); 
ра1 = 192 + (63 / (1+1)); 
с1:2 = РАТЕТТЕВСВ ( ра1, ра1, ра1); 
// если размер рамки равен 1 
1Е ( з1хеВта == 1) 
{ 
// устанавливаем стандартные цвета 
с1:2 = ВСВ ( 255, 255, 255) ;. 
с1:1 = ВСВ ( 128, 128, 128); 
} 
// если размер рамки отрицательный, меняем цвета местами 
1Е ( з12еВга < 0) 


Стр = с1:1; 
Баг = с1г2; 
} 
е15е 
{ 
бир = с1г2; 
Баг = с111; 


// рисуем две линии 
Ргам1, ( ЮОС, гесф.1еЕфе, гесё.бор, гесе.г1аВе, гесе.бор, &пр); 
Ргам1, ( ОС, гесф.1еЕе, гесе.бор, гесе.1еЕе, хгес®.роб$бом, %пр); 
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// обрабатываем промежуточное значение рамки 
1Е ( ( Вогаегк < 0) && (1 == эз1хеВга - 1) && ( э1леВга > 1)) 
{ 
РгамЪ ( ВОС, гесе.1еЕЕ + 1, гес®.Боббом - 1, гес®.тг1ане, 
тесё.роебом - 1, ВСВ (1,1, 1)); 
РгамЪ ( ВОС, гес®.г1аве - 1, гесе.бор + 1, тгес®.г19ь® - 1, 
тесё.БоЕфош, ВОВ (1, 1, 1)); 
} 
е15е 
( 
Ргам1, ( БОСС, гесё.1еЕЕ + 1, гесе.Бобеом - 1, гес®.г1аве, 
гесе.Бобом - 1, Баг); 
РгамЪ ( ВОС, гесе.г195Е - 1, гес®.бор + 1, гесе. главе - 1, 
тесе.БоЕбот, Баг); 
} 
// немного уменьшаем размер прямоугольника 
ТоЕ1абекесе ( &гесё, -1, -1); 


} 
// функция для рисования линии 
уо1А ОПгамЪ ( НОС ВОС, 1орд 1, 1ора &, 1ора г, 10109 Ь, СОЪОВВЕЕ с1г) 
{ 
// используем два пера 
НРЕМ пемРеп, о1аРеп; 
РОТМТ ро1пё; 
// создаем новое перо 
пеиРеп = СгеабеРеп ( Р$ $О1ТО, 1, с1г); 
// выбираем новое перо и сохраняем старое 
о1ЧРеп = ( НРЕМ) Зе1есеОБ]есе ( ВОС, пемРеп); 
// новая позиция 
МоуеТоЕх ( ВОС, 1, %, &ро10®); 
// рисуем линию 
ТареТо ( ВОС, г, Ъ); 
// восстанавливаем старое перо 
Зе1есеОБ]есе ( ВОС, о1аРеп); 
// освобождаем ресурсы 
Ре1ебебБ]ес® ( пемРеп); 
} 
// функция для вывода текста на кнопку 
у014 ЗеЕВоекопТехЕе (НОС ВОС, ВЕСТ гесё, сваг* СарЕ1оп, СОТОКВЕЕ ТехЕС1) 
{ 
// устанавливаем новый и сохраняем старый цвет надписи 
СОГОВВЕЕ о1АС1т = ЗекТехеСо1охг ( ВОС, ТехеС1г); 
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// устанавливаем режим прозрачности и отсечения фона 

ЗеёВКМоае ( ВОС, ТВАМЗРАВЕМТ); 

// выводим текст в область кнопки 

РгамТехЕ ( ВОС, СарЕ1оп, зЕт1еп ( Сарё1оп), &гес\, 
ОТ СЕМТЕВ | ОТ ЭТМСТЕГТМЕ | ОТ УСЕМТЕВ); 

// восстанавливаем прежний цвет надписи 

ЗесТехЕСо1ог ( ВОС, 019С1:); 


Теперь у нас есть такие же возможности для управления цветом, каки в 
языках У1зиа| Вазс или У1виа! С#, но при этом мы сохранили все достоин- 
ства прямого программирования интерфейса \Иш32 АРТ. 


18.1.2. Раскрывающийся список 


Раскрывающийся список очень удобно использовать для хранения большого 
количества строковых значений с последующим выбором. Главным досто- 
инством этого элемента является небольшой размер, который он занимает 
в окне программы. 


Прежде чем перейти к программированию, мне бы хотелось объяснить один 
важный момент при использовании списка, о котором многие начинающие 
программисты не догадываются. Это касается создания данного элемента 
управления в редакторе ресурсов. Если вы заметили, созданный по умолча- 
нию список не разворачивается при нажатии на кнопку со стрелкой. Чтобы 
решить данную проблему, следует щелкнуть левой кнопкой мыши прямо на 
стрелке. После этого просто потяните курсором за нижнюю сторону разме- 
точной линии, пока не получите необходимый размер. 


Теперь поговорим о том, как можно изменить цвет фона и текста для рас- 
крывающегося списка. В отличие от кнопки, список состоит из двух эле- 
ментов управления: поля редактирования (Еа Вох) и стандартного списка 
(115 Вох). Поэтому для него требуется несколько иной подход. Посмотрите 
в листинге 18.7, как можно реализовать выбор цвета для раскрывающегося 
списка. 





: Листинг 18.7. Обработка цвета для раскрывающегося списка 
// главная функция диалогового ( или обычного) окна 


ВООТ, САБЬВАСК Мур1аРгос ( НИМО Бипар1а, ОТМТ пеззаде, МРАКАМ эРагам, 
ТРАВАМ 1Рагам) 


// создаем дескриптор кисти 

зсаф1с НВВОЗН ВВга$в; 

// получаем дескриптор окна нашего списка 

НИМО ЮМуСопюоВох = бебро1аТ6ем ( Пмпар19, ТОС МУСОМВОВОХ); 
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// обработка сообщений 
зм1ЕсВ ( шеззаде) 
{ 
сазе ИМ ТМТТОТАГОС: // инициализация диалога 
( 
// создаем логическую кисть желтого цвета 
НВго$В = Сгеабе$о11АВгазВ ( ВСВ ( 255, 255, 0)); 
} 
тесагп &гие; 
// обработка цвета для списка и окна редактирования 
сазе ИМ СТЬСОБЬОВИТЗТВОХ: 
сазе ММ СТЬСОГОВЕОТТ: 
{ 
// задаем прозрачный фон 
ЗесВКМоче ( ( НОС) чРагам, ТВАМЗРАВЕМТ); 
// цвет текста в списке, если необходимо 
зееТехЕСо1ог ( ( НОС) мчРагаш, ВСВ ( 200, 200, 27)); 
// цвет фона текста тоже желтый 
ЗееВКСо1ог ( ( НОС) иРагам, ВСВ ( 255, 255, 0)); 
геогр ( ТВЕЗОЬТ) ВВгазв; 
} 
гебагп 6гце; 
сазе ММ РЕЗТВОУ: // завершение работы программы 
( 
// удаляем логическую кисть 
Ре1ефе0ю}есе ( ЮВгазп); 
} 


гебаго %гце; 


} 
тебогп ЕАБЬЗЕ; 


Вы можете комбинировать разные варианты для фона и текста. Если цвет 
текста не указан, будет использован системный цвет (как правило, это чер- 
НЫЙ). 

Работа со шрифтами ничем не отличается от работы с кнопкой, описанной 
ранее. Единственное, что нужно учитывать при изменении высоты шриф- 
та, — это высота элементов списка. Ее следует изменять (при рисовании 
собственного списка) в соответствии с размером шрифта. Для этого исполь- 
зуется сообщение св_ЗЕТТТЕМНЕТСНТ. 


А теперь давайте рассмотрим еще одну интересную и полезную возмож- 
ность, позволяющую перетаскивать в раскрывающийся список файлы из 
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других окон посредством технологии "Агав-ап4-Чгор" (Перетащить и отпус- 
тить). Прежде всего, построим специальный класс для поддержки процеду- 
ры перетаскивания файлов. В листингах 18.8 и 18.9 представлен образец 
такого класса. 


// подключаем файл определений для оболочки 
#1ос1а4е <зБе11ар1.Н> 
// объявление класса 
с1азз Огааргор 
{ 
рую11с: 
Ргаа)гор (); // конструктор 
-Ргааргор (); // деструктор 
//. общедоступные функции 
// выбор элемента управления 
\у01а АебасВСопего] ( НИМО ВСоп®го1); 
// обработка файлов 
уо1а АЧЧЕ1Ле ( НИМО БСопетго1, сопзе сваг* Е11е); 
рг1уафе: 
НИМО т Вира; // дескриптор окна элемента управления 
ИМОРВОС ш Рапс; // указатель на функцию окна 
// связь класса с оконной функцией 
$$аф1с ТВЕЗОШТ САБЬВАСК Е11е$0кор ( НИМОЬ ВИпа, ОТмМР шза, 
МРАВАМ иРагаш, ТРАВАМ 1Рагам); 
// обработка событий перетаскивания файлов для оконной функции 
1оп9 АаачЕ11езРгос ( НИМОЬ Б\ра, отТмТ пза, МРАВАМ мчРагам, 
ТРАВАМ 1Рагам); 


}; // окончание класса 





Листинг 18.9. Файл ОгадОгор.срр 


ф1пс1а4е "зЕдаЁх.в" 
#1ос1аае "Огарргор.В" 
// реализация класса 
Ргадргор :: Огаадргор () 
{ 

МОТ; 

м; 


п рипа 


ш_Еапс 
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Ргадргор :: -Огааргор () 
{ 
// освобождаем ресурсы 
1Е (м Бипа != 0) 
{ 
// восстанавливаем прежнюю процедуру окна 
зеси1паомЪопа ( п Бипа, сир ИМОРВОС, ( ЪОМС) м Езпс); 
// удаляем точку входа для использованной процедуры окна 
ВепоуеРгор ( м Пипа, "ОВАСб ОВОР_Н_"); 
ш_Випа = м; 


} 
ТВЕЗОЬТ САБЬВАСК Огадргор :: Е1]езргор ( НИМО Бира, отТмМТ пза, 
МРАВАМ мРагаш, ТРАКАМ 1Рагам) 


// получаем дескриптор из внешнего окна 
Ргадргор* агад = ( Огадргор*) бефРгор ( ЮМпа, "ОВАС ОВОР Н_"); 
1Е ( 'Чагад)гебагпт 0; // проверяем результат 
// подключаем нашу процедуру окна 
тебсаги агад->АааЕг11езРгос ( БИпа, пза, мРагам, 1Рагам) ; 

} 

Лора Бгадргор :: АаяЕ11езРгос ( НИМО Вира, ОТМТ мза, ИМРАВАМ чРагам, 

ТРАВАМ 1Рагапм) 


// обрабатываем нужные нам сообщения 
э\1ЕСВ ( п$9) 
{ 
сазе ММ _СТОЗЕ: 
сазе ММ ПРЕЗТВОУ: 
{ 
// при завершении работы освобождаем ресурсы 
Зеи1паомЬопа ( Випа, сиь ИМОРВОС, ( ОМС) м Еапс); 
ВепоуеРгор ( ПВМпа, "ОВАС_ ОВОР_Н "); 
м_пмла = 0; 
} 
Бгеак; 
// обрабатываем перетаскивание файлов 
сазе ММ ОВОРЕТЬЕЗ: 
// определяем число перетаскиваемых файлов 
ОТМТ оСоопеЕ11ез = ОгадОцегуЕ11е ( ( НОВОР) мРагам, 
ОхХЕРЕЕЕЕЕЕ, 0, 0); 
// выделяем буфер для временного хранения имени файла 
сНаг тр [МАХ РАТН]; 
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} 


// обрабатываем файлы 

Бог ( пр51дреа 106 1 = 0; 1 < оСоспЕЕ1ез; 1++) 

{ 
// получаем имя перетаскиваемого файла 
РгадОцегуЕ11е ( ( НОВОР) иРагаш, 1, Чтр, МАХ РАТН); 


// пропускаем, если это папка 


1Е ( ЕТЬЕ АТТАТВОТЕ ОТВЕСТОВУ != ( беег11еАкег1Юмеез ( пр) & 
ЕТЬЕ АТТВАТВОТЕ ОТВЕСТОВУ)) 


// добавляем имя файла в список 
АЧЯЕ11е ( В\ра, вр); 
} 
} 
// завершаем процедуру перетаскивания 
РгачЕР111$В ( ( НОВОР) чРагам); 
тебоги 0; 
} // ера зи1Е св 
// передаем данные во внешнюю оконную процедуру 
гебагп Са11\1паомРкос ( ш_Еапс, ИМпа, м5, мРагаш, 1Рагам); 


// функция инициализации и выбора элемента управления 
уо1А ОРгадч)гор :: АбфасЬСопего1 ( НИМР ВСорпего1) 


{ 


} 


// сохраняем дескриптор элемента управления 

п рипа = ВСопего1; 

// устанавливаем на всякий случай поддержку Ргад & Огор 

ЗеЕ\1паомФопа ( п Випа, СИЬ ЕХЗТУШЕ, беби1оаомопа ( м Бута, 
СМТ ЕХЗТУЦЕ) | М5 ЕХ_ АССЕРТЕТЬЕЗ); 

// закрепляем новое свойство для окна элемента управления 

ЗееРгор ( м Вмпа, "ОВАС ОВОР_Н_", ( НАМОШЕ) &№1$); 

// устанавливаем новую оконную функцию и сохраняем старую 


м Еопс = ( ИМОРВОС) Зе \1рао\Ъопя ( м пита, сит, ИМОРВОС, 
( ТОМС) Е\Лезргкор); 


// функция обработки полученных файлов 


уо1А Огааргор :: 


{ 


АЗаЕ11е ( НММО ПСопёго], сопз® сваг *Е1]е) 


// копируем в список только имена файлов 
сВаг* $; 

$ = зЕгтсЬкЕ ( Е11е, '\\'); 

СВаг %ир[МАХ_РАТН]; 

$Егсру ( тр, 5+2); 
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// добавляем имя файла в раскрывающийся список 
ЗепЧМеззаде ( ПСопего1, СВ АБОЗТВАТМС, 0, ( ПРАВАМ) ( ЦРСТЗТВ) тр); 
ЗепМеззаде ( ЮСопЕго1, СВ _ЗЕТСОВЗЕЬ, 0, 0); 


Получился удобный класс обработки перетаскивания файлов в окно списка. 
Для того чтобы применить класс Рхадогор, необходимо выполнить две ос- 
новные операции: 


|. Объявить класс ргааОгор. 


2. Вызвать функцию АефасвСопего1, передав ей в качестве аргумента деск- 
риптор раскрывающегося списка. 


В листинге 18.10 показан пример работы с классом ргаархор. 


Листинг 18.10. Пример использования класса Ргазбгор 





// подключаем необходимый файл 

#1пс1аае "Огарргор.В" 

// главная функция диалогового ( или обычного) окна 

ВООГ САБЪВАСК Мурб1аРгос ( НИМО Бупар]а, ОТМТ пеззаде, МРАВАМ мчРагам, 
ТРАВАМ 1Рагат) 


// объявляем наш класс 
з{а*1с ОЮгааОгор ЯгааСопфо; 
// получаем дескриптор окна нашего списка 
НИМР ЮМуСопроВох = Сбеер1аТеет ( Вмпаб1а, ТОС _МУСОМВОВОХ) ; 
// обработка сообщений 
зи1ЕсЬ ( щеззаде) 
{ 
сазе ИМ ТМТТОТАГОС: // инициализация диалога 
{ 
// инициализируем класс и закрепляем за ним список 
Ягач.АксасВСопего1 ( РМуСопфоВох); 
} 
гебатп сгае; 


} 


тебагип ЁЕа1зе; 


Вот и все, что необходимо сделать. Теперь можно смело копировать файлы 
в список посредством технологии "агаё-ап4а-4гор". Думаю, потенциальные 
пользователи вашей программы быстро оценят простоту и удобство этого 
способа работы с файлами, ставшего поистине важным и необходимым во 
всех операционных системах У/Лш4о\5. 
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18.1.3. Поле редактирования 


Этот простой элемент управления позволяет вводить и редактировать текст, 
а также взаимодействовать с буфером обмена. Мы, как и прежде, рассмот- 
рим только те возможности, которые недоступны через редактор ресурсов. 


Чтобы установить цвет фона или текста, можно применить код из листин- 
га 18.11. 





: Листинг 18.11. Использование цвета для поля редактирования 
// главная функция диалогового ( или обычного} окна 


ВОО САБТВАСК Мур1аРгос ( НИМО Бмрар019, ОТМТ пеззаде, ИРАВАМ мчРагап, 
ТРАВАМ 1Рагам) 


// создаем дескриптор кисти 
5фаЕ1с НВКО$Н ВВгазВ; 
// получаем дескриптор поля нашего списка 
НИМО ЬМуЕЧ1ЕВох = Сефр191еем ( Випар19, ТОС МУЕОТТВОХ) ; 
// обработка сообщений 
$\1Есй ( шеззаде) 
{ 
сазе ММ ТМТТОТАТОС: // инициализация диалога 
{ 
// создаем логическую кисть синего цвета 
ПВго$В = Сгеабебо]1АВгазВ ( ВСВ (0, 128, 255)); 
} 
тесагп &гце; 
// обработка цвета для поля редактирования 
сазе ИМ СТЬСОЬОВЕРТТ: 
{ 
// выделяем сообщение для поля редактирования 
1Е ( ( НММО) 1Рагам == БМуЕЗТЕВох) 
{ 
// задаем прозрачный фон 


ЗееВКМоЧе ( ( НОС) мРагаш, ТКАМЗРАВЕМТ); 

// цвет текста в списке, если необходимо 
ЗеёТехЕСо1ог ( ( НОС) мРагаш, ВСВ ( 200, 200, 27)); 
// цвет фона текста тоже синий 

ЗеёВКСо1ог ( ( НОС) мРагаш, ВСВ (0, 128, 255)); 


гекагп ( Т1ВЕЗОГТ) ЬВгазЬ; 


) 
} 


тебатгп &гое; 
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сазе ММ РЕЗТВОУ: // завершение работы программы 
{ 
// удаляем логическую кисть 
Ре1ефеоОБ]есе ( ВВгазВ); 
} 
тебагп 6гце; 


} 
тегагп РГАБЗЕ; 


Рассмотрим еще одну возможность, поддерживаемую полем редактирова- 
ния. Как вы знаете, данный элемент управления с успехом применяется для 
организации ввода пароля пользователя. Обычно реальные буквы и цифры 
пароля отображаются в виде символов звездочек "*', что затрудняет опреде- 
ление настоящего кода. В листинге 18.12 показан отрывок из программы, 
позволяющий просматривать скрытый пароль в поле редактирования. 


‚ Листинг 18.12. Просмотр скрытого пароля в поле редактирования 
// главная функция диалогового ( или обычного) окна 


ВОО. САБЪВАСК Мур1аРгос ( НИМР рирар1а, ОТМТ пеззаде, МРАВАМ эРагам, 
ТРАВАМ 1Рагам) 


// обработка сообщений 
$\1ЕсВ ( шеззаде) 
{ 
сазе УМ СОММАМР: 
1Е ( НТМОВО ( мРагам) == ЕМ ЗЕТЕОСО5) 
{ 
1Е ( Тз\1паом ( ( НИМО) 1Рагам)) // если это окно 
ЗромРаззмога (); // пытаемся открыть пароль 
} 
Бгеак; 
} 
гебсагп ЕАБЗЕ; 
} 
// функция для просмотра пароля 
уо1А ЗпомРаззмога () 
{ 
РОТМТ ро1рЕ; 
// получаем текущие координаты курсора 
СеЕСсагзокРоз$ ( &ро1п6); 
// определяем дескриптор окна 
НИМО РХ = И1пЧомЕгопРо1пе ( ро1пЕ); 
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// открываем пароль 

Зеп9Меззаде ( ЮХ, ЕМ ЗЕТРАЗЗИОВРСНАВ, 0, 0); 

// обновляем поле редактирования 

Ведгам\тпаом ( РХх, МОГ, МОБ, ВОМ ЕВАЗЕ | ВОМ ТМУАТТОАТЕ); 


Итак, мы перехватываем сообщение ЕМ зЗЕТЕГОСО$ (фокус ввода для клавиату- 
ры), посылаемое полю редактирования, и вызываем функцию $помРаззмога. 
Хотя представленный пример не очень удобен в использовании, он пол- 
ностью реализует поставленную задачу. Читателям же рекомендую приме- 
нять "горячие" клавиши для вызова функции ЗВомРаззмога, когда курсор 
мыши находится в области окна с паролем. 


18.1.4. Список 


Стандартный список, как и раскрывающийся, помогает упорядочить боль- 
шое количество отдельных записей, предоставляя удобный интерфейс для 
быстрого поиска и выбора нужного элемента. 


Выбор шрифта ничем не отличается от рассмотренных ранее элементов 
управления, а работа с цветом показана в листинге 18.13. 


: Листинг 18.13. Использование цвета для стандартного списка 
// главная функция диалогового ( или обычного) окна 


ВООТ, САЛ.ВАСК Мур19Ргос ( НИМО Бмпар19, ОТМТ пеззаде, ИРАВАМ уРагам, 
ТРАВАМ 1Рагам) 


// создаем дескринтор кисти 
зфаф1с НВКОЗН ВВгазВ; 
// получаем дескриптор окна нашего списка 
НИМ ЮМут15ЕВох = беео19Теем ( Випар19, ТОС МУБТЗТВОХ); 
// обработка сообщений 
5м1Еср ( пеззаде) 
{ 
сазе ИМ ТМТТЬТАТОС: // инициализация диалога 
{ 
// создаем логическую кисть красного цвета 
ЮВгозВ = Сгеафебо11аВгазь ( ВСВ ( 255, 0, 0)); 
} 
гебагп &гие; 
// обработка цвета для списка 
сазе ММ СТЬСОБОВЬТ$ТВОХ: 
{ 
// выделяем сообщение для поля редактирования 
1Е ( ( НММО) 1Рагам == ВМуЕа Вох) 
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// задаем прозрачный фон 


ЗееВКМоае ( ( НОС) мРагаш, ТВАМЗРАВЕМТ); 

// цвет текста в списке, если необходимо 
ЗесТехеСо1ог ( ( НОС) мРагаш, ВСВ (0, 0, 0)); 
// цвет фона текста тоже красный 

ЗееВКСо1ог ( ( НОС) иРагам, ВСВ ( 255, 0, 0)); 


хебагп ( ТВЕЗОШЬТ} ВВгазВ; 
} 

} 

тебигпл ©хое; 

сазе ММ РЕЗТВКОУ: // завершение работы программы 

{ 
// удаляем логическую кисть 
Ре1ефеоОБ]есе ( ЮВгизь); 

} 

гесатп ©гае; 

} 
тебакп КАЬЗЕ; 


Далее мы рассмотрим довольно интересную возможность, позволяющую 
добавлять в обычный список значки (иконки). Для упрощения кода вос- 
пользуемся библиотекой МЕС и напишем расширенный класс, производ- 
НЫЙ ОТ СТАЗЕВох, НО Сначала изменим некоторые свойства нашего списка 
в редакторе ресурсов. Откройте вкладку 51е$ и выберите в списке Омпег 
дга\ строчку Ихей, а также установите флажок На$ $15. Это необходимо 
сделать, поскольку рисование и обработка текста в списке ложится пол- 
‘ностью на нас. После этого создайте новый класс тсопЪ1зе и заполните его, 
как показано в листингах 18.14 и 18.15. 





Листинг 18.14. Описание файла [соп $ЕВ 





с1а55 Тсоп115е : раЪ11с СЬАЗЕВох // производный от класса МЕС 
{ 


рар11с: 
ТсопЬ15е (); // конструктор 
—ТсопЪ15е () { } // пустой деструктор 


// общедоступные функции 
// функция для определения иконок 
Ууо1а АааТсопз ( НТСОМ БТсоп); 
// функции для добавления новой записи в список 
\%01Я Ааа5Ег1паТсоп ( ЬРСТЗТВ 1рз2ТехЕ, ип$1дпеа 116 аТсоп); 
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у01А ТлзегЕ5Ег1паТсоп ( .РСТУТВ 1рэз2Техе, л1пЕ 11еет, 
п$19пеа 116 оТсоп); 
// добавим в класс обработку сообщения ИМ ОКАИТТЕМ 
// { { АЕХ УТВТОАЬ ( Топ115) 
раБ11с: 
%у1:6ца1 уо1А РгамТ®ет ( ТРОВАИТТЕМЗТВОСТ 1рОгамТеет$кас*); 
// } } АЕХ УТВТОВЬ 
ргофескеа: 
// добавим класс для хранения иконок 
СТтаде! 15 п_Тсоп$115%; 
// { { АЕХ М9С ( Тсоп11 5%) 
// МОТЕ - Ве С1аззМ1хатЯ м111 а@ апЯ гепоуе тмешретг ЕапсЕ1опз реге, 
// } } АЕХ_М$6 
РЕСЬАВЕ МЕЗЗАСЕ МАР () 
}; // окончание класса 


Листинг 18.15. Описание файла |соп$%срр 


#1пс1оае "зеЧаёх.Ь“" 
Нпс1аае "ТсорЬ15%.6" 
// реализация класса 
1<сопЬ1$8 :: Тсоп1зе () 
{ 
// создаем контейнер для хранения иконок 
п Тс0п$11$%.Скеафе ( 16, 16, ТЬС СОЪОВ | ТЬС МАЗК, 10, 10); 
} 
// пустая карта сообщений, созданная мастером 
ВЕСТМ МЕЗЗАСЕ МАР ( Тсопр15е, С115%Вох) 
// { { АЕХ М$С МАР ( Тсоп11 5) 
// МОТЕ - Ве С1аз5М1хак 111 а@Я ап гепоуе парр1па пасгоз Неге. 
// } } АЕХ М5С МАР 
ЕМР МЕЗЗАСЕ МАР () 
// реализация функций 
У01А Тсоп115е :: АЧЯТсоп$ ( НТСОМ БТсоп) 
{ 
п _1с0п$1156.Ааа ( НТсоп); 
} 
\01Я Тсоп1156 :: Ааа ек1паТсоп ( ТРСТЗУТК 1рз2Техе, опз1а9пеа 11 аТсоп) 
{ 
СТа5ЕВох :: Аа г1па ( 1рз2Тех®); 
} 
уо1А ТсоП115$е :: ТлзегЕ5Ег1паТсоп ( ПРСТЗТЕ 1р52Техе, 1пе 1ТГ%ею, 
ипз19пеЯ 1пеЕ аТсоп) 


} 
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СТ1$5%Вох :: Тпзеге5еу1па ( 11$ем, 1рз2Тех®); 


// функция рисования нашего списка 
у01а ТсопЪ15еЕ :: ОкамТеет ( БРОВАМТТЕМ$ТВОСТ 1рбгамТеет5® уас®) 


{ 


СОС* рос = СОС :: ЕгомНапа1е ( 1рОхамТеещб®гас®->ВОС); 
// определяем необходимые переменные 
СЗЕг1па БаЕ; // буфер для текста 
СОТОВВЕЕ со1ог; // цвет текста 
1105$1д91еа 1пе оТсоп$; 
116 1Ваг = 0; 
СВесе КГосиз ( 1рОкамГфетбегас®->гсТфем); 
СВесе ОцфЕАгеа ( Госуз); 
СВесе ТехЕ ( КГоса$); 
СРо1пе ро1пе ( Госи$.1еЕе, Госа$ .®ор); 
// стиль для отображения текста 
91519пеа 1пе и5%у1е = ОТ УСЕМТЕВ | ОТ ТЕТ; 
// устанавливаем режим фона 
1Вдг = ррС->5е ВКМоае ( ТКАМЗРАВЕМТ) ; 
// если элементов в списке нет, рисуем пустое поле 
1Е ( (106) 1рогачТееюбе гасе->16етТр < 0) 
{ 
1Е ( ( 1рОгамГеембекас&->1еетАсе1оп & ОБА ЕОСО$) && 
( 1рогачГ сем гис®->1$хембеафе & 005 РОСО5)) 


// рисуем прямоугольник для фокуса 
РОС->РгамГосазКесе ( &1р0огамТ{ет5егасе->гсГеем); 
} 
е1зе 1Ё ( ( 1рогамтГеенбегасЕ->1еещАсЕе1оп & ОБА ГОСИУ$) && 
!( ТрогамТеембегис®->16етбхафе & 00$_РОСО5) ) 


// рисуем прямоугольник для фокуса 
РОС->ОгамГосизКесе ( &1рргамТещгасе->гстТеем) ; 
} 
тефагп; 
} 
// насчитываем отступ между текстом и иконкой 
Техе.1еёе += 20; 
ТехЕ.фор += 2; 
ОпЕАгеа.1еЁе += 20; 
// рисуем иконку в заданной области 
иТсоп$ = ( ипз1апеа 11) 1рогамГеещбегасе->1$етРафа; 
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14Е (м Тсопз1156) 
п_Тсоп3Т1$®.Бгам ( рос, чТсопз, ро1фпё, ТЬО МОВМАЬ | 
Тр ТААМ$РАВЕМТ); 
// обрабатываем выделенные пункты списка 
12 ( ( 1рогамТеет$ Е гас&->1(етбфафе & 00$ ЗЕЪЕСТЕР) && 
( 1рогачГ еее кис®->16етАсе1от & ( ОРА РВАМЕМТТВЕ | ОРА_$ЕЪЕСТ))) 
{ 
// используем системный цвет для заливки 
СВгазВ Бгизр ( ::беебузСо1ог ( СОТОК НТСНЬТСНТ)); 
рОС->Е111КВес® ( &ОлеАкеа, &Буа5зП); 
} 
е15е 1Е (!( 1рогачмГетбетасе->1етбфтафе & О00$_ЗЕЩЕСТЕО) && 
( 1рогамТеем5Е гис&->1$етАс®1от & ОРА_$ЕЪЕСТ)) 


СВудёВ БгазВ ( ::беебузСо1ог ( СОТОК ИТМООИ)); 
РОС->Е111Весе ( &ОцеАкеа, &БгазВ); 
} 
// обрабатываем фокус для выбранного пункта 
1Е ( ( 1рогамТеем$® гас&->1{ещАсе1оп & ОБА _ЕРОСО$) && 
( 1рогачГеетбекисе->16етбфтафе & 005 _РОСО$) } 


РОС->ОгамчГосизВесе ( &Госиз); 
} 
е1зе 1Е ( ( 1рОгамтТеемб Е гис®->1бетАс®1оп & ОРА_РОСО$) && 
!( 1рогамТеембе касе->1$етбтафе & 00$ РОСИ5)) 


РОС->ОРгачЕосизВесе ( &Госуз); 
} 
// обрабатываем цвет для текста 
1Е ( 1рогачТ кем егисе->1$ембфтафе & 005_ЗЕТЕСТЕО} 


со1ог = роС->5еТехеСо1ог ( ::СеёбузСо|1ог ( СОТШОК_НТЕНЫТСНТТЕХТ)); 
е15е 1Е ( 1рогачТеетбегасе->1еетббафе & ОР$_ОТЗАВЬЕО) 

со1ог = роС->5ееТехеСо1ог ( ::СеёбузСо1ог ( СОЬОК_СВАУТЕХТ)); 

е15е 

‘со1ог = рОС->5ееТехеСо1ог ( ::СбеббузСо1ог ( СОЬОВ_ИТМРОИТЕХТ)); 


// получаем текст и выводим его в список 
РОС->ОгамТехе ( раЁ, -1, &Техе, и5%у1е | ОТ САТСВЕСТ); 
рОС->ОгамТехе ( БоЁ, -1, &Техе, и5%у1е); 

// восстанавливаем цвет текста и режим отображения 
РОС->5еЕВКМо4е ( 1Вдг); 

РОС->5е{ТехеСо1отг ( со1ог); 
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Пример использования класса тсопт1зе показан в листинге 18.16. Замечу 
только, что желательно работать с иконками размером 16х16, поскольку для 
более крупных (32х32 или 48х48) придется пересчитывать размеры элемен- 
тов в списке. 





"Листинг 18. 16. "Пример и использования класса Тсоптаз& 


#$1пс]1аае "Тсоп115е.6" 

// создадим список производным от нашего класса Тсоп115% 

ТсопЪ13е м _Тсоп113$%; 

// добавим необходимые иконки 

м ТсопЪ15е.АЧаЯТсопз ( ТоадТсоп ( АЁхбеесТльсапсеНапЯ1е (), 
МАКЕТМТВЕЗОЧВСЕ (ТОТ_ТСОМ1))); 

п 1Тсоп1156.АааТсоп$ ( ТоааТсоп ( АЕхбееТтзкапсеНапа1е (), 
МАКЕТМТВЕЗООВСЕ (ТРТ_ ТСОМ2))); 

п_1Тсор115е.АааТсопз ( ТоааТсоп ( АЕхСбесТп5апсеНаптяа1е (), 
МАКЕТМТВЕЗОЧВСЕ (ТОТ ТСОМЗ))); 

// добавим в список значения 

п Тсопр1$%.АЧа5ек1паТсоп ( "Ада1", 0); // первая иконка 

п Тсопр13е.Ааа$е:1паТсоп ( "Ког@", 1); // вторая иконка 

п Тсоп14зе.АдазегапоТсоп ( "Оре1", 2); // третья иконка 

п ТсопЬ1 $. Тлзеге5ех1паТсоп ( “Ама1", 3, 0); // первая иконка 


Как видите, небольшая доработка стандартного списка позволила нам полу- 
чить прекрасный графический интерфейс, намного улучшив восприятие 
информации. 


И последнее, что мы рассмотрим, — это добавление возможности перетас- 
кивания файлов в список посредством технологии "Аагаё-ап4-Чгор". Для это- 
го нам понадобится уже написанный ранее класс ргадокор. Единственное, 
что придется сделать, — это немного изменить функцию АдаЕ11е, как пока- 
зано в листинге 18.17. 


// функция АЧАЕ11е 
У01Я Огадркор :: АЧЯЕ11е ( НММО ВСопёго1, сопз® сВаг *Е11е) 
{ 

// копируем в снисок только имена файлов 

спаг* $; 

3 = эзегесре ( Е11е, '\\') 

сВаг пр [МАХ_РАТН]; 

зЕгсру ( р, 5+2); 
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// добавляем имя файла в стандартный список 
ЗепОМеззаде ( ПСопего1, 1В АШБЗТВТМС, 0, ( ПРАВАМ) ( ТРСТЗТВ) &тр); 
ЗепОМеззаде ( ЮСопего1, ТВ ЗЕТСОВЗЕТ, 0, 0); 


Как вы заметили, все изменения коснулись только имен сообщений, ис- 
пользуемых для стандартного списка: тВ_АООЗТВТМС И ТВ _ЗЕТСОВ$Е:.. 


Следующий элемент управления КсН ЕЧИ очень похож на поле редактиро- 
вания (Е4и Вох), но имеет гораздо более широкие возможности. Например, 
на его основе можно легко создать полноценный текстовый процессор, не 
уступающий программам УогА или У!ог4Ра4. Здесь мы не будем рассматри- 
вать программирование данного элемента управления, поскольку для этого 
потребуется отдельная книга. Замечу только, что материал, рассмотренный 
ранее для Еаи Вох, практически полностью будет работать и с Вей Еди. 


18.1.5. Линейка прокрутки 


Этот элемент управления присутствует практически везде. Откройте любую 
папку или обозреватель Интернета, и вы обнаружите как минимум две ли- 
нейки прокрутки: вертикальную и горизонтальную. Важность данного эле- 
мента трудно переоценить, ведь благодаря ему можно максимально быстро 
и удобно просматривать большие документы или графику. Даже производи- 
тели манипулятора "мышь" добавили специальное колесико, управляющее 
прокруткой изображения в окне. 


Чтобы изменить цвет фона линейки прокрутки, нужно обработать систем- 
ное сообщение им стьсоговзсвовьвАВ, как показано в листинге 18.18. 





: Листинг 18.18. Изменение цвета фона для линейки прокрутки 


// главная функция диалогового ( или обычного) окна 
ВООГ САБВАСК Му019Рхос ( НИМО Випар1а, ОТМТ пеззаде, МРАВАМ иРагаш, 
ТРАВАМ 1Рагат) 


// создаем дескринтор кисти 
$фаф1с НВАОЗН ЮВгазВ; 
// получаем дескриптор окна нашей линейки прокрутки 
НИМО №Му5сго11 = Себр19Тееш ( Имтар19, ТОС _МУЗСВОЬЦ); 
// обработка сообщений 
5м1ЕсВ ( меззаде) 
{ 
сазе ИМ ТМТТОТАТОС: // инициализация диалога 
{ 
// создаем логическую кисть оранжевого цвета 
ЮВгазВ = Сгеабебо11АВгазВ ( ВСВ ( 255, 128, 0)); 
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тесатп гие; 
сазе ММ СТЬСОЪОВЗСВОШЬВАВ: // обработка цвета 
{ 
// выделяем сообщение 
1Е ( ( НИМО) 1Рагам == №Му5сго11) 
{ 
// цвет фона оранжевый 
геситп ( ТВЕЗОШТ) ВБВгазВ; 
} 
} 
тебагл &гкие; 
сазе ИМ РЕЗТВОУ: // завершение работы программы 
{ 
// удаляем логическую кисть 
Ре1ебеоБ]есе ( ВВгазВ); 
} 
тебигп &гие; 
} 
гебагп ЕАГЗЕ; 


В большинстве случаев линейки прокрутки добавляются автоматически, и 
нет необходимости в их перепрограммировании. Замечу только, что для об- 
работки сообщений от линейки следует использовать сообщения им Н$своы, 
И ИМ У$СВОГ. 


18.1.6. Статический элемент 


Данный элемент позволяет выводить на экран статический или динамиче- 
ский текст, отображать иконки, графические файлы, а также использоваться 
вместо кнопки. В большинстве случаев он применяется для оформления 
всевозможных надписей в окне программы. Чтобы статический элемент мог 
обрабатывать сообщения (например, нажатия мыши}, в его свойствах следу- 
ет установить флажок № Ну. 


Изменение отображаемого шрифта для этого элемента полностью анало- 
гично описанному ранее для кнопки. Для изменения цвета можно приме- 
нить код, как показано в листинге 18.19. 





Листинг 18.19. Изменение цвета текста для статического элемента управления 


// главная функция диалогового ( или обычного) окна 
ВООТ САБТВАСК Мур1аРгос ( НИМО Випар1а, ОТМТ веззаде, ИРАВАМ иРагаш, 
ТРАВАМ 1Рагам) 
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// создаем дескриптор кисти 
зсае1с НВАОЗН ВВгазв; 
// получаем дескриптор окна нашего злемента 
НИМО ВМубеае1с = беер19тТеем ( №мпа019, ТОС МУЗТАТТС); 
// обработка сообщений 
$м1еСВ ( меззаде) 
{ 
сазе ММ ТМТТОТАТОС: // инициализация диалога 
{ 
// создаем логическую кисть с системным цветом кнопки 
ЮВга$Ь = Сгеабебо119Вгазр ( беЕ5у5Со1ог ( СОШОВ_ВТМЕАСЕ)); 
} 
тебатл гие; 
сазе ММ СТЬСОГОВЗТАТТС: // обработка цвета 
{ 
// выделяем сообщение 
1Е ( ( НММО) 1Рагам == ЮМу5$а61с) 
{ 
// устанавливаем желаемый цвет текста и ( или) фона 


// цвет текста зеленый 


ЗееТехеСо1ог ( ( НОС) мРагам, ВСВ (0, 128, 0)); 
// цвет фона текста 
ЗеЕВКСо1ог ( ( НОС) мРагаш, беббузСо1ог ( СОГШОВ_ВТМЕАСЕ)); 


гесагп ( ТВЕЗОШТ) ЮВгазВ; 


} 
тебатп гие; 
сазе ММ РЕЗТВОУ: // завершение работы программы 
{ 
// удаляем логическую кисть 
Ре1ефеоБ]есеЕ ( БВгаз$|); 
} 


гебагп Егое; 


} 
тебагп КГАБЗЕ; 


Несмотря на простоту, статический элемент управления может полностью 
преобразить внешний вид программы. Для примера создадим класс (произ- 
ВОДНЫЙ ОТ С5как1с), позволяющий использовать различные трехмерные эф- 
фекты и нестандартные возможности. В листингах 18.20 и 18.21 представле- 
ны соответствующие файлы нового класса Мад1с3каЕ4с. 
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Листинг 18.20. Файл Мадсе{айс.В 


// определение класса 
с1аз5 Мадс$ак1с : рую11с С5фае1с 
{ 
руЮ11с: 
Мадтс5фаезс (); 
—Мач1с5фафзс (); 
// общедоступные функции 
// установка нового текста 
уозА ЗееТехе ( сопзЕ С5Ег1па& Техё); 
// установка рамки 
у014 ЗеЕВог4ег ( Боо1 БОп); 
// преобразование в интернет-ссылку 
уо1а ЗеерапКкииИ ( Боо1 БОп); 
// установка режима прозрачности 
у01а ЗееТгапз ( Юоо1 БОп); 
// установка цвета текста 
у014А ЗееТехЕСо1ог ( СОБОВВЕЕ со1ог); 
// установка подтекстового фона 
%уо1а ЗееВагТехЕСо1ог ( СОШОВВЕЕ со1ог); 
// установка трехмерного зффекта 
%у01а Зе 3ЗреЁЕесе (Юоо1 ЮОп, 2106 ЕЁЕЁес®); 
// установка разделителя 
%701А Зеберагаеог ( Боо1 Оп}; 
// виртуальные функции 


// { { АЕХ УТЕАТЧОАЬ ( Мадас$тае1с) 
// } } АЕХ УТЕТОАЬ 
ргофескеа: 


уо1а ОрдафеСопего1 (); // функция перерисовки злемента 
НВВОЗН т_Вта$Ь; // основная кисть 

БооЪ ш ЮТгапз; // признак прозрачности 

оо? м ЮЗа; // признак трехмерности 

Боо1 м Ю3Зер; // признак разделителя 

11Е м ЕЕЁес®; // номер эффекта 

СОГОВВЕЕ ш ТехЕСо1ог; // ивет текста по умолчанию 
СОТОВВЕЕ м ВдуТехеСо]ог; // цвет подтекста по умолчанию 
// карта сообщений класса 

// { { АЕХ М$б ( Мадасбхае1с) 

аЁх пза \01А ОпбузСо1огСвапае ({); 

аЕх п549 уо1а ОпРалпе (); 

аЕх тзд уо1А ОпЬВиеЕопбомп ( ОТМТ пЕТадз, СРофаЕ ро1пе); 
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// } } АЕХ_М$6 
РЕСТАВЕ_МЕЗЗАСЕ МАР () 
}; // окончание класса 





// реализация класса Мад1с5%а®1с 
#$10с1о4е "з&ЧаЁх.Б" 

#1рс1а4е "Мач1с$$а&1с.В" 

// конструктор 


Мад1с5фа®1с :: Маа1с$$аё1с () 
{ 
п _Вказр = ::Сгеабебо11АВгазН ( :;СбеёбузСо1ог ( СОБОВ_ЗОРАСЕ) ); 
п _ТехёСо1ог = ::беббузСо1ог ( СОТОВ_ИТМРОИТЕХТ); 
т ВагтехеСо1ох = ВСВ (0, 0, 0}; // белый цвет 
ш Юбер = Еа15е; 
п ЮТкапз = ЁЕа15е; 
м ЮЗа = Еа15е; 
м ЕЕЕесе = 0; 
} 
// деструктор 
Мад1с5$а®1с :: -Маач1с56ае1с () 
{ 
// удаляем кисть 
::Ое1ебеОБ]есе ( м ВгазВ); 
} 
// карта сообщений 
ВЕСТМ МЕЗЗАСЕ МАР ( Мад1с5$а%1с, Сзба&1с) 
// { { АЕХ М5С МАР ( Мад1с$а®е1с) 
ОМ ИМ ЗУЗСОБОВСНАМСЕ () 
ОМ ММ РАТМТ () 
ОМ ИМ ТВОТТОМРОмМ () 
// } } ВЕХ МЗС МАР 
ЕМО МЕЗЗАСЕ МАР () 
// функция обработки цвета 
у01А Мад1с$$а&1с :: ОпЗузСо1охСВападе () 
{ 
Сзфаё1с :: ОпЗузСо1огСВапае (); 
// удаляем старую кисть 
1Е (м ВуазН) 
::Ое1ебеОБ]есе ( м ВгазИ); 
// и создаем новую 
м Вгазр = ::Сгеабебо11АВгазВ ( беёбузСо1окг ( СОГОВ_ЗЬЕАСЕ)); 
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// перерисовываем наш элемент управления 
ОрааееСопёго1 (); 
} 
// функция обработки нажатия левой кнопки мыши 
\у01Я Мад1с5%$аЕ1с :: ОпЬВаеопрома ( ОЗ1МТ рЕ1адз, СРо1пЕ ро1п®) 
{ 
С5г1п9 мии; 
себ\И1паомТехе ( мим); 
// вызываем системную функцию для открытия страницы 
ЗВе11Ехесифе ( МОБЬ, "ореп", ммм, МОБЬ, МОШ., $И_ЗНОММОВМАЪ); 
Сзбаё1с :: ОпЪВаббопбомп ( пЕ1ад$, ро1); 
} 
// функция рисования нашего статического элемента 
\у01Я Мад1с5а&1с: :ОпРа1п () 
{ 
// получаем контекст устройства рисования 
СРазп ОС ас ( 515); 
// объявляем необходимые переменные 
С5еу1па тр; 
СВесе гесе; 
СВ тар Бир; 
СОС* РБС; 
ОИОВР ЧмРоз = 0; 
ОТМТ оМоае; 
СОГОВВЕЕ со1отТех*; 
// получаем размеры клиентской области окна 
СеЕС11епЕВес® ( гес®); 
// сохраняем текст в переменную 
Сеем1паомТехе ( &пр); 
// если нужно отобразить разделитель, выполняем этот код 
1Е (м Ь5ер) 
{ 
СВесе гсИ1а; 
// получаем полный размер элемента 
Сее\1паомВесе ( хсМ1п); 
// задаем начальный режим отображения 
УМо4ае = ОТ ТОР; 
// получаем стиль статического элемента 
РИМОКР @м5&у1е = Сеё5®у1е (); 
// рисуем прямоугольник 
ас.ОтаиЗавВесе ( 0, гсм1п.Нелаве () / 2, ксиза.иаавь (), 2, 
:: СеббузСо1ог ( СОБОВ_ЗОЗНАРОЙ), 
::СеббузСо1ок ( СОГОК_ЗОНТСНЫТЕНТ)); 
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// обрабатываем текст в зависимости от текущего стиля 
1Е ( ам5еу1е & 55_СЕМТЕВ) 
{ 


тар = " " + %пр; 
тр += " и ; 
Моде |= ( ОТ СЕМТЕВ | ОТ УСЕМТЕВ | ОТ 5ТМСБЕЦТМЕ); 


) 
е1зе 1Ё ( 9м5%у1е & 55 ВТСНТ) 
{ 
тр =" "+ в; 
ОМоде |= ОТ _ВТСНТ; 
) 
е1зе 
{ 
Стр += " 
Моде |= ОТ ТЕЕТ; 
} 
// сохраняем старый шрифт 
СРопе* рО1а = ас.5е1есеОБ]есе ( СбееКопе ())}; 


". 
‘ 


// устанавливаем системный цвет фона 
4с.5е ВКСо1ог ( ::СеёбузСо1ог ( СОБОВ_ВТМЕАСЕ)); 
// выводим текст 
ас.РгамТехе ( ®тр, гесё, Моде); 
// восстанавливаем старый шрифт 
Яс.5е1есеОБ)]ес® ( р01а); 
// выходим из функции 
гебаги; 

} 

// обрабатываем режим прозрачности 

1Е ( !м БТгап5) // прозрачность используется 

{ 

// создаем новый совместимый контекст 

РОС = пем СОС; 

РОС->Сгеа&еСотра&*161е0С ( &4с); 

Бтр.Сгеа<еСотра*161еВ1Етар ( &4с, гесё.М1аер (), гесё.Нелаье 

РОС->5е1есеОБ]есе ( &5тр); 

} 

е1з5е // прозрачность не используется 

{ 

РОС = &4с; 

) 

// устанавливаем режим вывода 

Мое = роС->5еВКМоае ( ТКАМЗРАВЕМТ); 
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// устанавливаем требуемый цвет текста 
со1огТехе = рОС->5еТехеСо1ог ( м Тех&Со]1ог); 
// создаем сплошную кисть и заполняем прямоугольник 
1Е ( м БТгапз) 
{ 
СВхазь г; 
Ьг.АбфасЬ ( м ВхазрЬ); 
РОС->Е111]Весё ( гесё, &6г); 
Бг.Бебась (); 
} 
// выводим текст 
ЧмРоз = ОТ СЕМТЕВ; 
РОС->ОкамТех®е ( ипр, кесе, ЧмРоз); 
// обрабатываем выбранный эффект 
1Е (м ьЗа) 
{ 
РОС->5е ТехЕСо1ог ( м ВдгТех&Со1окг); 
5м16св ( м ЕЕЕес®) 
{ 
сазе -4: 
гесе.ОЕЕзееВесе ( -4, -4); 
БгеаКк; 
сазе -3: 
гесе.ОЕЕзееВес® ( -3, -3); 
БгеакК; 
сазе -2: 
хесе.ОЕЕзееКесе (-2, -2); 
БгеаКк; 
сазе -1: 
гесе.ОЕЕзееВесе ( -1, -1); 
БтеаК; 
сазе 0: 
гхесе.ОЕЕзееВесь (0, 0); 
Ьгеак; 
сазе 1: 
хесё.ОЕЕзееВесе (1, 1); 
ЬгеаК; 
сазе 2: 
гес&.ОЕЕзекВесе (2, 2); 
Ьгеак; 
сазе 3: 
гесе.ОЕЕзеквесе (3, 3); 
Цгеак; 


Глава 18. Элементы управления 607 


сазе 4: 

гесе.ОЕЕзекВесе (4, 4); 

Ьгеак; 
} 
// выводим текст 
рОС->ОгамТех& ( &тр, гесё, ОмРоз$); 
} 
// восстанавливаем параметры контекста 
рРОС->5е ВХМоЧе ( Моде); 
РОС->5е{ТехСо1ог ( со1огТех®); 
// если используется режим прозрачности, копируем данные 


1Е ( '!м БТгапз) 
{ 
Яс.В1ЕВ1 (0, 0, гесе.М1абь (), гесё.Нелоре (), рос, 0, 
0, ЭВССОРУ); 
Че1ефе рос; 


} 
// функция обновления 
%01Я Мад1с5$ае1с :: ОрдабеСопего1 () 
{ 
СВесе ( гес®); 
Се\1пдомВесе ( хес®); 


КеагамИ том (); 
СесРагепе ()->5сгеепТоС11ете ( гес®); 
СеерРагепе ()->Тпуа11Ча®екесе ( гесе, &гае); 


СееРагеп® ()->ОрЧа®ем1ааом (); 
} 
// общедоступные функции 
. уо1а Мад1с5$аё1с :; ЗеёТехе ( сопзе СЗ х1па& Тех) 
{ 
ЗеЕИ1паомТехе ( Тех®); 
Орда&еСопего1 (); 
} 
\014 Мад1с5$а®1с :: ЗееТехЕСо1ог ( СОБОВВЕЕК со1охг) 
{ 
п _ВотТехеСо1ог = со1ог; 
Орда еСоп%хо1 (); 
} 
\019 Мад1с5$а1с :: ЗееВогаехг ( Боо1 БОп) 
{ 
1Е ( Бой) 
Моа1Еу5*у1е ( 0, М5 _ВОВОЕВ, 5ИР_ОВАМЕВАМЕ); 
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е15е 
Мо91Ру5*у1е ( М5 ВОВОЕВ, 0, $МР ОВАИЕВАМЕ); 
} 
у014 Мад1с5$аё1с :: ЗеёВагТехЕСо1ох ( СОГОВВЕЕ со1ог) 
{ 
ш ТехеСо1ог = со1ог; 
Орда*еСопего1 (); 
} 
%014 Мад1с5$ае1с :: зеётаюКИММ ( Боо1 БОп) 
{ 
1Е ( БОп) 
МоЧ4 Еузеу1е (0, 55$ МОТТЕУ); 
е15е 
Моа1Гузку1е ( 55 МОТТЕУ, 0); 
} 
%014 Мад1с5$ак1с :: ЗееТгапз ( Боо1 БОп) 
{ 
м БТкапз = БОп; 
МоЧ91Рузку1еЕх ( 0, М5 _ЕХ ТВАМЗРАВЕМТ); 
Орда®еСопёго1 (); 
} 
У014 Мад1с5$аё1с :: ЗееЗБеЕЁЕесе ( 6оо1 БОп, 10 ЕЁЕЁес®) 
{ 
м 63а = 601; 
м ЕЕЕес® = ЕЕЕеск; 
Орда еСопего1 (); 
} 
У014 Мад1с5$аё1с :: Зеббераха®ох( Боо1 РОп) 
{ 
м О5бер = Бой; 
Орда еСопе го] (); 


Вот и получился несколько улучшенный класс для поддержки статическо- 
го элемента управления. Несмотря на достаточно понятный интерфейс это- 
го класса, приведу пример его использования, представленный в листин- 
ге 18.22. 





: Листинг 18.22. Пример работы с классом Мадас3 ас 


// объявим переменную класса 
Ма91с3{а&1с м МуЗбае1с; 
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// красный текст и желтая тень 
п_Мубае1с. бес ТехЕСо1ох ( ВСВ ( 255, 0, 0)); 

м _Му5&ак1с.зееВагТехеСо1ох ( ВСВ ( 255, 255, 128)); 
// выпуклый текст 

м Му5бак1с.5есзреЕЕесе ( &гче, 1); 

// или создадим адресную ссылку 

п Мубеаё1с. зес1окимМ ( &гое); 


Как видите, ничего сложного в работе с классом нет. 


18.2. Дополнительные элементы 
управления 


Кроме стандартных элементов управления, в \ш4о\5 существует набор до- 
полнительных, которые еще называют общими. К ним относятся: элемент 
анимации (Апипае), управление датой и временем (Оме Тите Рскег), рас- 
ширенный раскрывающийся список (СотБоВохЕх), счетчик (5рт Вох), ин- 
дикатор выполнения (Ргоргез$ Ваг), ползунок (ЗИ4ег), управление горячими 
клавишами (Но! Кеу), список просмотра картинок и текста (1.15 Мае\), дре- 
вовидный список (Тгее Ме\), управление вкладками (Таб), сетевой адрес 
([Р А@9гез$), окно свойств (Ргорему $Нее!), строка состояния (Заз Ваг$), 
панель инструментов (Тоофаг), окно подсказки (Тоо@р), список изображе- 
ний (|таве 14150. Я не буду рассматривать все эти элементы управления 
подробно, поскольку об этом написано достаточно много книг. Здесь я рас- 
скажу о наиболее часто используемых элементах и приведу примеры, 
имеющие сугубо практический интерес для программистов. 


Прежде всего необходимо инициализировать дополнительные элементы 
управления, чтобы их можно было без проблем применять в своей про- 
грамме. Для этого предназначена специальная функция тп1ЕСопопСопе го] эЕх. 
Она имеет единственный аргумент — указатель на — структуру 
ТРТИГТСОММОМСОМТВОТЗЕХ. Данная структура позволяет выбрать только те эле- 
менты, которые понадобятся в программе. В листинге 18.23 показано, как 
следует вызывать функцию инициализации. 
Листинг 18.23. Инициализация дополнительных элементов управления 
// главная функция программы 
106 АРТЕМТВУ М1пМалип ( НТМУТАМСЕ П]пзбапсе, Н1АЗТАМСЕ БКРгеу!пзфарсе, 

ТРУТВ 1рСтаь1пе, 10 пСтабвом) 


М5С изд; 
ТИТТСОММОМСОМТВОТ$ЗЕХ сопего]13$; 
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// функция регистрации класса окна программы 
1Е ( !ВедузЕехМуС1азИ1пЧомз { РТпзфапсе)) 
гебагп ( КАЪЗЕ); 
// заполняем поля структуры ТМТТСОММОМСОМТВОЬ$ЕХ 
сопфего1.5.4м512е = з17ео0оЕЁ ( ТМТТСОММОМСОМТВОТЗЕХ); // размер 
// выбираем злементы управления 
сопего]1$.ЧмТСС = ТСС ИТМ95_С1А$5ЕЗ; 
// инициализируем системную библиотеку Сомс®132.4911 
101 СомтопСойпе го1$Ех ( &соп®го13$); 
// выполняем другие необходимые действия 
// 
// запускаем обработку сообщений И1пЯомз$ 
\11]е ( СбеЕМеззаде ( &мза, МОШЬ 0, 0)) 
{ 
Тхап$1а*еМеззаде ( &т$9); 
О1зраес!Меззаде ( &154); 
} 


тебиуп ( пза.мРагкат); 


Как видно из листинга, инициализацию общих элементов управления жела- 
тельно выполнять после регистрации главного окна программы, в данном 
случае после функции вед1зЕехМуС1азИпаомз. Структура тмттсоммомсомтвотьзех, 
как я уже говорил, позволяет выбрать определенные элементы управления. 
В табл. 18.1 представлены возможные значения поля дитсс, которые могут 
комбинироваться между собой с помощью оператора ИЛИ. 


Таблица 18.1. Возможные значения поля аитсс 








Значение Описание 
СС _М1М95 СТАЗ$Е$ Аптае, Но Кеу, [151 Мем, Заз Ваг, Ргодгезз Ваг, Тар, 
ТооШр, ТооЪаг, Тгее Меми, Зрт Вох 
СС ОЗЕВЕХ СЬАЗЗЕЗ СотроВохЕх 
СС ОРРОИМ_СЬА$$ Зри 
СС _ТВЕЕУТЕМ СТАЗЗЕЗ Тгее Мем 
СС АМТМАТЕ СТАЗ5 Апитае 
СС_ВАВ_СЬАЗ5Еб За{и$ Ваг, Тоофаг, Тоо#р 
СС _РАТЕ_СТАЗЗЕЗ Бае Пте Рскег 
СС НОТКЕУ_СЬАЗ$ Но\ Кеу 
СС _ТМТЕВМЕТ СТАЗЗЕ$ |Р Адаге$$ 
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Таблица 18.1 (окончание) 


Значение Описание 
ТСС ТТ5ТУТЕМ СЪАЗЗЕЗ [151 Мем 

ТСС _РВОСВЕЗ$ СТА$$ Ргодгез$ Ваг 
1СС_ТАВ_СТАЗ5ЕЗ ТаБ 


Если вЫ используете библиотеку МЕС, вызывать функцию 
то ЕСопшопСопего1зЕх необязательно. А теперь приступим непосредственно к 
вопросам программирования дополнительных элементов управления. 


18.2.1. Древовидный список 


Данный элемент управления является, пожалуй, одним из самых исполь- 
зуемых. В операционной системе \УМп4о\$ можно открыть любую папку, 
чтобы убедиться в этом. Все папки представлены в удобном для восприятия 
виде, и реализовано это с помощью древовидного списка (Тгее Уе\м). Мы 
разберем наиболее интересный случай, связанный с отображением структу- 
ры всех логических дисков системы наподобие того, как это выглядит в 
папке Мой компьютер. 


Прежде всего, нам понадобится создать вспомогательный класс, непосред- 
ственно работающий с древовидным списком. Если вы работаете с библио- 
текой МЕС, можете просто взять за основу класс сткее\1ем. Для тех же, кто, 
как и я, предпочитает чистый \Ип32 АР1, приведу пример реализации тако- 
го класса (назовем его стгее) в листингах 18.24 и 18.25. 


$10с1аае <сопасёт1.В6> 
// объявляем наш класс 
С1аз5 СТгее 
{ 
раб] 1с: 
СТгее (); 
-СТгее (); 
// общедоступные функции 
// инициализируем дескриптор древовидного списка 
%01Я Тп1ЕНИМОТгее ( НИМО ЮТгее); 
// получаем дескриптор древовидного списка 
нимр деенимр () { гебакп м Рупа; ) 
// получаем дочерний элемент списка 
НТВЕЕТТЕМ бефсЬ11аТеем ( НТВЕБТТЕМ РТеем) сопз®; 
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// получаем номер выбранного изображения 
Боо1 СеетфЕетТиаде ( НТВЕЕТТЕМ ВТеет, 1п6& пПааде, 
1068 пбе1есфкеаТтаде) сопз&; 
// получаем текст элемента списка 
Боо1 СеетеетТехЕ ( НТВЕЕТТЕМ РТбеш, ПРТЗУТВ 1рз2Техе, ОТМТ пВоЕЁЕег) 
соп5е; 
// получаем следующий элемент списка 
НТВЕЕТТЕМ СесМехТкем ( НТВЕЕТТЕМ БТ&ет, ОТМТ пСоае) соп$&; 
// получаем следующий соседний элемент 
НТВЕЕТТЕМ СеёМ№ех&516]1па16ем ( НТВЕЕТТЕМ БТ&ем) сопзе; 
// получаем родительский элемент списка 
НТВЕЕТТЕМ СекРагепеТ&ет ( НТВЕЕТТЕМ БТфет) сопз%; 
// получаем выделенный элемент 
НТВЕЕТТЕМ Сеёбе1ескеЧТеет () соп$%; 
// проверяем, является ли элемент дочерним 
Боо1 Т&ешНазСр11Акеп ( НТВЕЕТТЕМ РГ ем) сопз*; 
// подключить список изображений 
НТМАСЕТТСТ бееТтаде!1 $ ( НТМАСЕТТЗТ 61], 
ОТМТ птааде = ТУЗТЬ МОВМАЪ); 
// установить указанный элемент списка 
Боо1 ЗееТет ( ТРТУТТЕМ рем); 
// второй вариант функции установки элемента списка 
Боо1 ЗеёТеем ( НТВЕЕТТЕМ РТ&ет, ОТМТ пМазк, ПРСТЗУТВ 1рз2Кем, 
106 пПоаде, 106 пбе1есбеЯТтаде, ОТМТ пбфафе, ОТМТ пбфафеМазк, 
ТРАВАМ ]Рагаш); 
// установить изображение для указанного элемента списка 
Боо1 Зе ТетШиаае ( НТВЕЕТТЕМ ЮТеет, 106 пТпаде,1пё пбе1есфеЧТтаде); 
// установить состояние указанного элемента списка 
Ьоо1 ЗееТеЕетбеафе ( НТВЕЕТТЕМ БТ&ет, ОТМТ п56афе, ОТМТ оЗ$бафеМазк); 
// установить текст для указанного элемента списка 
Боо1 бееТЕешТехе ( НТВЕЕТТЕМ РТЕем, ЪРСТЗТВ 1рз2Т%ет); 
// удалить все элементы списка 
роо1 Бе1ефеА11Т%етз (); 
// удалить указанный элемент списка 
Боо1 Бе1ебетеем ( НТВЕЕТТЕМ БТеем); 
// развернуть древовидный список 
Боо1 Ехрапа ( НТВЕЕТТЕМ ЮГ%6еш, ОТМТ пСоае = ТУЕ ТОССЬЕ); 
// вставить новый элемент в список 
НТВЕЕТТЕМ ТозегеТкет ( ТРТУТМ5ЕВТЗТВОСТ 1р1ТпзехЕ5$%кис®); 
НТВЕЕТТЕМ ТпзегетТекет ( ОТМТ оМазк, ТРСТЗТК ]рз7Тфёет, 116 пТшаде, 
1пЕ пзе]есхедТтаде, ОТМТ п5$абе, ОТМТ п5&афемазк, ГРАВАМ 1Рагкам, 
НТВЕЕТТЕМ БРагеп®, НТВЕЕТТЕМ БТизегсАЕтег); 
НТВЕЕТТЕМ ТозегетТеем ( ПРСТЗТВ 1рз2Гет, НТВЕЕТТЕМ ЮРагепе = ТУТ ВООТ, 
НТВЕЕТТЕМ РТпрзег(АЁфег = ТУТ ТАЗТ); 
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НТВЕЕТТЕМ ТпзегЕТеем ( ТГРСТЗТВ 1рз2Г6ещ, 1п6 пГтаде, 
106 пзе1ессеаТтаае, НТВЕЕТТЕМ ВБРагепе ТУТ _ВООТ, 
НТВЕЕТТЕМ ВТпзег%АЁЕфег = ТУТ _ЬАЗТ); 
// выделить указанный элемент списка 
Роо1 бе1есЕТеем ( НТВЕЕТТЕМ ВТеем); 
// загрузка файлов для выбранной папки 
роо1 ГоаЯЕ11ез ( НИМР №1156, свак *Ро1аег); 
рг1уаее: 


| 


НИМР м Вупа; // дескриптор древовидного списка 
}; // окончание класса 





: Листинг 18.25. Файл СТгее.срр 
#1пс1а4е "ъзЕдаЁх.в" 
#1осТаае "СТгее.в" 
// реализация класса СТгее 
СТгее :: СТгее () 
{ 
}. 
СТкее :: -СТгее () 
{ 

1Е ( м вмпа) 

п рипа = м; 

} 
уо1А СТгее :: Та1ЕНИМОТгее ( НИМО ЮТгее) 
{ 

п рипа = БТгее; 
} 
НТВЕЕТТЕМ СТгее :: СефСсь11АтТЕет ( НТВЕЕТТЕМ БТбем) сопз® 
{ 

хебокп ( НТВЕЕТТЕМ) бепаМеззаде ( м Вип, ТУМ СЕТМЕХТТТЕМ, 

ТУСМ СНТЬО, ( БРАВАМ) ВТ®ем); 

} 
Боо1 СТгее ;: беетТеетТтаде ( НТКЕЕТТЕМ БТЕет, 1168 пПладе, 
106& пбе]1есбеаПпаде) сопз® 


ТУТТЕМ +$еп; 

1Еещ.вТбем = ВТеей; 

1Еем.щазк = ТУТЕ ТМАСЕ | ТУТЕ_ЗЕЪЕСТЕОТМАСЕ; 

( Роо1) ЗепаМеззаде ( пм Вмпа, ТУМ СЕТТТЕМ, 0, 
( ТГРАВАМ) &16ещ); 


роо1 Ьгез 
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1Е ( Бгез) 


пГваде = 16еп.1Тщаае; 
пбе1есфеЯТщаде = 1$ем.15е1есфеЧТмаде; 


} 


тесак ргез; 


} 


Боо1 СТгее :: сбееТЕештехЕ ( НТВЕЕТТЕМ ВБТееш, РТУТЬ 1рз2Техе, 


ОТМТ пВаЕЕег) сопз® 


ТУТТЕМ 16еп; 

1$ем.БТЕем = БТееп; 
16ет.рэз2ТехЕ = 1р$2Техе; 
1$ ем. ссвТехЕМах = пВаЕЕег; 
1{ем.пазк = ТУТЕ ТЕХТ; 


тееогй 


} 
НТВЕЕТТЕМ 
{ 

херагп 


} 
НТВЕЕТТЕМ 


{ 
хебагп 


} 
НТВЕЕТТЕМ 


{ 
тебауп 


} 
НТВЕЕТТЕМ 


{ 
тебати 


} 


роо1 СТгее 


{ 


( 6001) ЗепаМеззаде ( м Бмпа, туУМ СЕТТТЕМ, 0, 
( ТРАВАМ) &16ем); 


СТгее :: СбебмехетТеем ( НТВЕЕТТЕМ БТеет, ОТМТ пСоае) соп$Е 


( НТВЕЕТТЕМ) бепаМеззаде ( м Вупа, туМ СЕТМЕХТТТЕМ, пСоае, 
( ГРАВАМ) ВТеем); 


СТгее :: СеЕ\№ехЕ51511п91ТЕем ( НТАЕЕТТЕМ БТЕеш) сопзе 


( НТАЕЕТТЕМ) бепаМеззаде ( м пупа, ТУМ СЕТМЕХТТТЕМ, ТУСМ_МЕХТ, 
( ГРАВАМ) пГем); 


СТгее :: СесРагепеТеем ( НТВЕЕТТЕМ БТееш) сопзе 
( НТВЕЕТТЕМ) ЗепаМеззаде ( м Пита, ТУМ_СЕТМЕХТТТЕМ, 
ТУСМ_ РАВЕМТ, ( ТРАВАМ) ВТфем); 
СТкее :: Себбе1есвеатТЕем () сопзЕ 
( НТВЕЕТТЕМ) ЗепаМеззаде ( м Вмпа, ТУМ СЕТМЕХТТТЕМ, 
ТУСМ САВЕТ, 0); 
ТбетНазСв1]агеп ( НТВЕЕТТЕМ ВТГ{ем) сопзе 


ТУТТЕМ 16еп; 
1Еещ.БТбем = пТем; 
1{ем.щазк = ТУТЕ СНТЬОВЕМ; 
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ЗепаМеззаде ( м Вмпа, ТУМ СЕТТТЕМ, 0, ( ТРАВАМ) &1%ем); 
гебагп 16ет.сСЬ11атеп; 
} 
ШМАСЕГТЗТ СТгее :: Зе Тщаде1$Е ( НТМАСЕГТ$Т В11, ОТМТ пТпаде) 
{ 
1Е ( Ват == 0) гебоки 0; 
хебоагп ( НТМАСЕГТЗТ) бЗепаМеззаде ( м Вита, ТУМ ЗЕТТМАСЕТТЗТ, пГмаде, 
( ГРАВАМ) ( ИМТ) ( НТМАСЕШТЗТ) В1т1); 
} 
Боо1 СТхее ;; ЗееТЕет ( .РТУТТЕМ ртГ%ем) 
{ 
хебихи ( Боо1} ЗепаМеззаде ( м Пита, ТУМ ЗЕТТТЕМ, 0, 
( ГРАВАМ) рт%ем); 
} 
роо1 СТгее :: ЗееТеем ( НТВЕЕТТЕМ ВТфет, ОТМТ пМазк, ЬРСТЗТВ 1рз2Геем, 
1пЕ пПааде, 1пе п5е1ескеЧТтаде, ОТМТ п5Еафе, ОТМТ пбфаееМазк, 
ТРАВАМ 1Рагат) 


ТУТТЕМ %1; 
$1.тазк = пМазк; 
Е1.ВТеем = БГеец; 
{1.зБабеМмазк = пбеафеМазк; 
С1.рэзхТехе = ( ,РТУТВ) 1р52Г%ецщ; 
{1.1Ттаде = ппааде; 
$1.з$афе = паке; 
Е1.15е1есседТтаде = пбе1есееаТмаде; 
$1.1Рагам = 1Ракац; 
хебокп ( 6001) ЗепаМеззаде ( м Бута, туМм ЗЕТТТЕМ, 0, 
( ГРАВАМ) &%1); 
} 
Боо1 СТгее :: Зее ТЕемТиаде ( НТВЕЕТТЕМ ВтТеет, 1пе пТтаде, 
11Е пбе1ессеаТмаае) 


хесаги зеетТеем ( БТЕеш, ТУТЕ ТМАСЕ | ТУТЕ ЗЕЪЕСТЕОТМАСЕ, МОБ, пплваде, 
пбе1есфедТмаае, 0, 0, №); 
} 
роо1 СТгее :: зееТеетбваее ( НТВЕЕТТЕМ ВТеЕем, ОТМТ пбфате, 
ОТМТ пЗбабеМазкК) 


хебогп ЗееТеем ( ИТЕеш, ТУТЕ 5ТАТЕ, МОБЬ, 0, 0, пббафе, пзфабеМазк, 
МОГ); 
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Боо1 СТгее :: ЗеЕТеемТехЕ ( НТВЕЕТТЕМ втТЕет, ГРСТЗТВ 1рз2Тет) 
{ 
тебагп зеетТеем ( ПТбет, ТУТЕ ТЕХТ, 1рз2Т{ещ, 0, 0, 0, 0, №); 
} 
Боо1 СТгее :: ОБе1ебеА111Теетз () 
{ 
тееагп ( роо1) ЗепаМеззаде ( м В\мта, ТУМ РЕБЕТЕТТЕМ, 0, 
( ТРАВАМ) ТУТ_ВООТ); 
} 
Боо1 СТгее :: Бе1ебе!Гфем ( НТВЕЕТТЕМ итеем) 
{ 
тееаги ( Боо1) ЗепдМеззаде ( м пмпа, ТУМ РЕБЕТЕТТЕМ, 0, 
( ТРАВАМ) ВТсем); 
} 
Роо1 СТгее :: Ехрапа ( НТВЕЕТТЕМ ВТеем, ОТМТ пСоае) 
{ 
тебагп ( Боо1) бепаМеззаде ( пупа, ТУМ ЕХРАМО, пСоде, 
{ ТРАВАМ) ВТеем); 
} 
НТВЕЕТТЕМ СТхее :: ТпзегеТЕею ( ЬРТУТМЗЕВТСТВОСТ 1рТпзеге5Е кис) 
{ 
хееакп ( НТВЕЕТТЕМ) 5епаМеззаде ( м Вмпа, тум ТМ5ЕВТТТЕМ, 0, 
( .РАВАМ) 1рТпзехе5егис+); 
} 
НТВЕЕТТЕМ СТгее :: ТпзегЕТеем ( ОТМТ пМазк, ГРСТЗТВ 1рэз2Теет, 116 пТтаде, 
10е пбе1естеаТтаде, ОТМТ пбфафе, ОТМТ п5басемазк, ПРАВАМ 1Рагам, 
НТВЕЕТТЕМ РБРахепе, НТВЕЕТТЕМ РТпзег%АЁкег) 


ТУТМЗЕВТЬТВОСТ &13; 
{15.ПРагепЕ = ПРагепт; 
{15.1$е.1Тщаде = пПладе; 
{15.1Сем.15е1есфед1Ттаде = пбе1есееаТмаде; 
{15.1Сещ. бабе = пбфбафе; 
{13.15ем. зсасеМазК = пзфафсеМазк; 
Е15.ВТлзегЕАЕсег = ВТлзегсАЕег; 
{13.15ещ.тазк = пМазк; 
$15.1Сещ.рзхТехе = ( ЬРТУТВ) 1рз21ТЕеп; 
{15.15етм.1Рагам = 1Рагап; 
хебахп ( НТВЕЕТТЕМ) бепаМеззаде ( м Вутпа, ТУМ ТМЗЕВТТТЕМ, 0, 
( ГРАВАМ) &%1$); 
} 
НТВЕЕТТЕМ СТгее :: ТпзехеТеем ( ТРСТЗТВ 1рз2Геш, НТВЕЕТТЕМ БРагепе, 
НТВЕЕТТЕМ БТазегеАЕХег) 
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тебогп ТпзегЕеТЕет ( ТУТЕ ТЕХТ, 1рз2Цец, 0, 0, О0, 0, 0, ПРагепк, 
ВТозегЕАЕЕег); 
} 
НТВЕЕТТЕМ СТгее :: ТазегстТеем ( Т.РСТЗТК 1рз2ТЕеш, 11 пПладе, 
106 пбе1ескедТтаде, НТВЕЕТТЕМ БРагепе, НТВЕЕТТЕМ БТозеусАЕсег) 


тебкакп ТпзегЕТЕем ( ТУТЕ ТЕХТ | ТУТЕ ТМАСЕ | ТУТЕ ЗЕЪЕСТЕОТМАСЕ, 
1рз2ТЕет, пПладе, пбе1ессеаТтаде, 0, 0, 0, БРахгепЕ, ВТизехЕАЕ ег); 
} 
роо1 СТгее :: Зе1лесеТеем ( НТВЕЕТТЕМ БТ ем) 
{ 
тебаги ( Роо1) ЗепаМеззаде ( м Пмпа, ТУМ ЗЕТЕСТТТЕМ, ТУСМ_ САВЕТ, 
( .РАВАМ) втТ+ем); 
} 
Боо1 СТгее :: ГоааЕ11ез ( НИМО №115, спват* Го14ег) 
{ 
НАМОБЕ ВБЕАПа = №; 
\Т№М32 ЕТМО РАТА а; 
сВах *р = М; 
// получаем указатель на строку 
р = Ро1аег; 
// обнуляем структуру поиска 
петзее ( &Е4А, 0, $12еоЕ ( И1М32_Е1МО РАТА)); 
фху 


\11е ( *р) р++; 
// обрабатываем путь 
1Е ( зЕхЛеп ( Го1аегк) < 4) // если корневая папка 
зЕхсру (р, "*.*"); // добавляем точку 
е1зе // иначе 
зЕгсру (р, "\\*.*"); // разделитель и точку 
// ищем первый файл или папку 
ВЕРапа = Р1]паЕ1т$%Е11е ( Ео14ех, &Еа); 
// если файл или папка найдены 
1Е ( пЕла != ТМУАЬТО НАМОГЕ УАГОЕ) 
{ 
Чо 
{ 
// пропускаем ненужное 
1Е ( Еа.сЕ11еМате[0] != '.' || 
(Еа.сЕ11еМаше[1] != '.' && Еа. сЕ11еМаше [1])) 


13Ехсру (р +1, Е4.сЕ11еМапе); 
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// если найдена папка, переходим к дальнейшему поиску 
1Е ( Еа. дмЕ11еАбегаБакез & Е ТЕ АТТВТВОТЕ ОТВЕСТОКУ) 
{ 
сопЕ1тое; 
} 
е1 зе 
{ 
// если найден файл, добавляем его в список 
ЗепаМеззаде ( №15, ТВ АРОЗТВАТМС, 0, 
( ТРАВАМ) ( ТРСТЗТВ) ЕАа.сг+]еМацще); 


} 

// переходим к поиску следующего файла 

} чье ( Е1паМехЕЕ11е ( ВЕлла, &Еа)); 
// закрываем дескриптор поиска 
Е1паС1озе ( БЕ1па) ; 
} 
е15е 
{ 

// не найден ни один файл 

Е1паС]1озе ( ВЕ1па); 

гебагп Еа1$е; 


} 

саёсв (.. .) 

{ 
// при любой ошибке выходим из функции 
1Е (БЕ1па) Е1паС1озе ( ВЕ1па); 
тебогп Ка1зе; 


гебаги Егае; 


У нас получился базовый класс для управления древовидным списком. Те- 
перь мы должны воспользоваться им для отображения структуры всех логи- 
ческих дисков, имеющихся на компьютере. Прежде всего, добавьте в.редак- 
торе ресурсов элемент управления Тгее Сопёго]. На вкладке 51/е$ установи- 
те следующие флажки: Наз Би боп$, На Нпез, Глпез аё гооё, Эпом з@есНоп 
амауз. Кроме этого, установите флажок ФегоЙ, который находится на 
вкладке Моге 5е$. Чтобы воспользоваться всеми преимуществами древо- 
видного списка (Тгее Уе\), построим рабочий класс Сткеемогк, производ- 
НЫЙ ОТ СТгее. В листингах 18.26 и 18.27 представлены файлы данного клас- 
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са. Не забудьте добавить в опциях компоновшика ссылку на библиотеку 
СотсИ32.16. 





Листинг 18.26. Файл СТгее\Могк.Н 








#1ос1аае <сойшсег1 > 
Н1пс1аае <56105).1> 
#1пс1аде "СТгее.в" 
// объявление класса СТхеемогк 
С1аз5 СТкееМогк : руб11с СТхее 
{ 
ру611с: 
СЕЯ1еохЕхЕ (); // конструктор 
-СЕЧ1ФокЕХЕ (); // деструктор 
// общедоступные функции 
// функция начальной инициализации 
уо1А Тп1Ог1уез ( НИМО 5019, Ьоо1 ЮВезеЕ = +кае); 
// определяем все доступные логические диски 
уо1А Ехрапарг1уез ( НТВЕЕТТЕМ БРахепЕТеем, НИМО Р115$); 
// перезагружаем древовидный список 
у01А Бе1ефеА11Ср11а ( НТВЕЕТТЕМ ВТЕет, 001 ТзЕпрЕу = &гае); 
// определяем полный путь в списке 
у01А СеЕРаЕЮТкее ( НТВЕЕТТЕМ ВТ$еш, сваз* Ойе, спаг* раЕЕег); 
рг1уаее: 
НТМАСЕЬТ$Т м 1; // список изображений 
НТВЕЕТТЕМ п_Оху_Вооф; // корневой узел для дисков 
НТВЕЕТТЕМ ш_РезКкор Воо®; // корневой узел для Рабочего стола 
// переменные для хранения строковых значений 
сваг м _Ог\у Мапе [500]; 
СВахг м_БезКбор Раб [350]; 
// функции для добавления данных в древовидный список 
НТВЕЕТТЕМ АааТеЕешттее ( сопзЕ сваг *паме, НТВЕЕТТЕМ БРагепеТфем, 
Боо1 ТзРо1аек, 11 Тсоп, 11 ТсопОреп); 
НТВЕЕТТЕМ АЗАаТеет( сопзЕ сваг* рав, НТВЕЕТТЕМ ПРагепе Тем, 
Боо1 13Ео1аег = Ёа1зе, ле Тсоп = -1, 11 Тсоп2 = -1); 
// функция обновления изображений в списке 
уо1А ВКеЁгезВТгее ( НТВЕЕТТЕМ БТЕеш, 116 1Ттаде); 
}; // окончание класса 





Лис 


тинг 18.27. Файл СТгее\№огК.срр 


#1пс1аае "зедаЁх.В" 
#1осТазе "СТгеемохКк.в" 


620 Часть /. Общие методы программирования в И/паоиз 


// глобальная переменная дескриптора программы 
НТУЗТАМСЕ 9 _В1Тпз{; 
// реализация класса СТкееМогк 
СТкееМогк :: СТгееМогкк () 
{ 
// инициализируем переменные класса 
ша = м; 
п_Рху_КооЕ = МО; 
п_РезКор Коое = МО; 
} 
СТкеемо"К :: -СТгеемогкКк () 
{ 
// удаляем список изображений из памяти 
Тиадет 15 Резекоу ( м 1); 
шм = М; 
} 
НТВЕЕТТЕМ СТгееМогк :: АЧдатЕештгее ( сопзЕ спа’ *папе, 
НТВЕЕТТЕМ пРагепеТеет, Боо1 ТзРо14ет, 11% Тсоп, 11 ТсопОреп) 


НТВЕЕТТЕМ ВГбеп; 
// вставляем новое значение в список 
ПТеем = ТпзехеТЕем ( паме, Тсоп, ТсопОреп, ВРагепеТфем); 
// если корневая папка, текст опускаем 
1Е ( Тэко1аег) ТозегЕТЕет ( "", БТбем); 
тебагп ИТем; 
} 
НТВЕЕТТЕМ СТгееМогк :: АЗаТЕем ( сопз® сваг* рай, НТВЕЕТТЕМ пРагепеТ®еем, 
Боо1 Т1зГо1аег = Ёа1зе, 106 Тсоп = -1, 116 Тсоп2 = -1) 


// объявляем структуру оболочки для получения информации о папке 
ЗНЕТЬЕТМЕО 561 Типо, $01 ТпбоОреп; 
// получаем информацию о маленькой иконке папки 
ЗНнсесЕ11еТпЁо ( рабфр, МОБ, &$61 ТпЕо, 517еоЕЁ ( ЗНЕТЬЕТМЕО), 
ЗНСЕТ РТЗРЬАУМАМЕ | 5НСЕТ ТСОМ | ЗНСЕТ 5МАБЬТСОМ); 
// получаем информацию о маленькой иконке открытой папки 
ЗНбееЕ11етоЁРо ( раёв, МИШЬ, &361_ТпЕоОреп, з12еоЕ ( ЗНЕТЬЕТМЕО), 
ЗНСЕТ ОТЗРЬАУМАМЕ | ЗНСЕТ ТСОМ | ЭНСЕТ ЗМАБЬТСОМ | ЗНСЕТ ОРЕМТСОМ); 
// выбираем нужную иконку и добавляем ее в список изображений 
те _Тсоп = Тсоп != -1 ? Тсоп : [паде 15 АдаТсоп ( м 1, 
$в1пЕо.ВТсоп); 
Е _ТсопОреп = Тсоп2 != -1 ? Тсоп2 : Цаадеьазе Ааатсоп ( пл", 
зВ1пЕо_ 5е1.ПТсоп); 
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// определяем список изображений для древовидного элемента управления 
Зее Ттаде!т15е ( м а, Т\УЗТЬ МОВМАГ); 
тебахп АЗаТЕетТхее ( э61пЕо.5201$р]ауМате, ПРагепеТеет, ТзЕо14декг, 
Тсоп, Тсоп2); 
} 
у01А СТкееМогКк :: ВеЁгезйТгее ( НТВЕЕТТЕМ БТбет, 10 1Тладе) 
{ 
НТВЕЕТТЕМ ВСогтТееш; 
110% 1№олпа1, 10реп; 
// определяем дочерний элемент списка 
ЮПСигТЕем = СебСср11АтТеет ( БТ%ем); 
// выполняем обработку 
\п1]е ( ВСагТЕем) 
{ 
// получаем картинки для двух состояний папки 
1Е ( сеетЕетТладе ( ВСагтТеетш, 1Могаа1, 1Ореп)) 
{ 
1Е ( 1МогиаЪф > ЕИеаде) И®югта1--; 
1Е ( 1Ореп > 1Ппаде) 1Ореп--; 
// устанавливаем значения картинок для элемента списка 
ЗеТеещтпаде ( ПСахТеет, 1Мотта]1, 1Ореп); 
} 
// если есть еще дочерние элементы, обрабатываем и их 
1Е ( ГеемНазСЬ11Ахей ( БСогТеем) !=0) 
{ 
// рекурсия 
ВеЁхезВТкее ( ВСагТеет, 1Ттадае); 
} 
// переходим к следующему элементу 
ВСихтТЕем = беЕМ№ехе$1511па9тТЕет ( пСихтТЕем); 
} // епа эй41е 
} 
// реализация общих функций класса 
уо1а СТгееМокК :: То1ЕОк1уез ( НИМО 6019, Боо1 ЬВезеф) 
{ 
ТРТТЕМТОЬТЗТ 1%6ем_Г15$%; 
сВак пр [350]; 
11Е 10езК Тсоп, 1МуСопрафсег Тсоп; 
// обновляем древовидный список 
1Е ( БВезеф) 
Ре1ефеА11Т$етз (); 
// очищаем список изображений 
Зее паче 1$е (м п, 0); 
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} 


// получаем путь к папке 'Рабочий Стол’ 
ЗНбесбрес1а1Ко1ЧетТоса®1оп ( №019, С$ТОЬ РЕЗКТОР, &1{ем 115%); 
ЗНбеЕРа®ВЕхгомтТ0Ъ1$Е ( 16ем 1136, р); 
// сохраняем путь в переменную класса 
зЕгсру ( м Резкеор Раб, тр); 
// создаем новый список изображений 
м = ТпадеЪ1$® Сгеафе ( бекбузкепМеех1с$ ( $М_СХ$ЗМТСОМ), 
СеЕЗузеетМеек1с$ ( $М СУЗМТСОМ), Т1С СОГОВ24 | ТЬС МАЗК, 10, 1); 
// устанавливаем цвет фона для списка изображений 
Гпаае!т 15 5ееВКСо1ог ( м ла, СбебзузСо1ок ( СОГОК \ТМРОм) }; 
// получаем корневые значки 
1езк Тсоп = Нпадеь1$е_АдаТсоп ( м а, ЕхекасеТсоп ( 9 ИТазЕ, 
"зре1132.а11", 34)); 
1МуСоприсег_Тсоп = падет 1$®_АдаТсоп ( м за, ЕхегасеТсоп( 9 ВТпзе, 
"5ве1132.а11", 15)); 
// добавляем в древовидный список корневые значки 
п Оку Вооф = АЧЯТеем Соге ( "Рг1уез", ТУТ _КООТ, ское, 
1МуСопрасех_Тсоп, 1МуСопривек_Тсоп); 


п Оезкор ВооЕ = АЧааТ%ем ( м Резкеор Раб, ТУТ ВООТ, Егае, 10езК Тсоп, 


10езК Тсоп); 


уо1А СТгееМогк :: ЕхрапаРх1уез ( НТВЕЕТТЕМ ПРагепеТеет, НИМО №1156) 


{ 


// если получен корневой узел 
1Е( ПРакеретТеем == п Оку Кооф®) 
{ 
срваг *р5; 
// удаляем дочерние элементы списка 
Ре]ефеА11С111а ( ВРагепеТеет, ЁЕа15е); 
// получаем буквы всех установленных в системе дисков 
СеЕТо91са10х1уе5г1п9$ ( 500, м _Огу Маме); 
р5 = м Оку Маме; 
// заносим все найденные диски в древовидный список 
\п11е ( *р5) 
{ 
АЧАаТеещ ( р5, м Огу Воо®&, Егае); 
р5 += збу1еп ( р5) + 1; 


} 

е15е 

{ 
// заносим в список имена найденных папок 
СсВаг разв [500]; 
сВак. раев2 {МАХ_РАТН]; 
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спаг $етр(МАХ РАТН]; 

\1ТМ32 ЕТМО РАТА ЕЕ; 

НАМОЬЕ ВЕ1зрта = №; 

// обнуляем структуру поиска 

петзее ( &ЕЁ, 0, 51хеоЕЁ ( ИТМ32_ЕТМО РАТА)); 

// определяем путь к элементу списка 

СесРаепТтее ( ПРагепеТеет, раб, ""); 

// удаляем дочерние элементы списка 

Ре1еЕеА11СЬ11а ( БРагепЕТеет, ЁЕа1зе); 

// определяем путь для поиска папок 

зЕгсру ( рафБ2, раЕП); 

зЕгсаЕ ( раЕф2, "*.*"); 

// ищем папки 

1Е ( ( Бета = Е1раЕ1езЕЕ11е ( раёь2, &ЕЕ)) == 
ТМУАРТО НАМОЬЕ УАГОЕ) гебаго; 


1Е ( ЕЕ. ЧмЕ11еАЕск1Рокез & ЕТЬЕ АТТАТВОТЕ ОТВЕСТОВУ)} 


71/ отсеиваем ненужное 
1Е ( ( зЕгстпр (ЕЁ. сЕ11еМате, ".") != 0) && 
( зЕгспр ( ЕЁ. СЕРП емаме, "..") !=0)) 


// получаем имя найденной папки 

5Егсру ( Еепр, раев); 

зЕгсаЕ { Еепр, ЕЁ.сЕ1]еМаме); 

// создаем новый элемент списка для найденной папки 
НТЕЕЕТТЕМ 146ем = АдаТеет ( бепр, ПРагепеТеем); 
ТозекЕТеет ( "", 16ет); 

5Егсру ( Еешр, ""); 


} 
// ищем следующую папку 
} бе ( Е1лаМехЕЕ11е ( БЕ1оа, &ЕЕ)); 
// завершаем поиск 
Е1оаС1озе ( ВЕ1па); 
ВЕ1ра = М; 


} 
$01 СТгеемогКк :: Пе]ефеА11Ср11а ( НТВБЕТТЕМ БТГЕем, Боо1 ТзЕтшр®еу) 
{ 

// получаем дочерний элемент списка 

НТВЕЕТТЕМ 1%ем СП11а; 

1{ет_СЬ11а = беесь11атТеет ( ВТеем); 
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// обрабатываем полученный элемент 
иЪ11е ( 1%ем_Св11а) 
{ 
108 1с0п1, 1соп2; 
// если дочерний элемент содержит свои дочерние элементы 
1Е ( Сбееср11атеет ( 16ем_СЪ11а)) 
// выполняем рекурсию 
Ре1ефеА11Ср11а ( беесь11атЕет ( 16ем СВ11а), 15Епрфу); 
// получаем оба значка для отображения элемента списка 
СеЕТфетТмаде ( 16ещ СЬ11а, 1с0п1, 1с0п2); 
// если необходимо, обновляем значки 
1Е ( 1с002 != 0 && 1соп2 != 1с0р1) 
{ 
// удаляем значок из списка изображений 
Тпадер1$е_Ветоуе ( м 1, 1соп2); 
// обновляем корневые узлы списка 
ВеЕгезрТгее ( м Оку Вооф, 1соп2); 
ВеЕгезрТгее ( м ОезКор Воо®, 1соп2); 
} 
1Е ( 1с001 != 0) 
{ 
// удаляем значок из списка изображений 
Тиаде 15 Ветоуе ( м Ши, 1с0101); 
// обновляем корневые узлы списка 
ВеЁгезрТгее Ппадез (м_Огу Вооф, 1011); 
ВеЁЕгезпТгееТладез ( ш Безкор Воое, 1с0оп1); 
} 
// удаляем дочерний элемент из списка 
Ре1ететеет ( 1Еет_Ср11а); 
// устанавливаем список изображений 
ЗекТпаде!т1зе ( м ца, ТУЗТЬ МОВМАТ,) ; 
// получаем следующий дочерний элемент 
16ещм СЬ11а = бесы аТеем ( ЬТ6ем); 
} // ера ие 
// если нужно, вставляем в список пустой элемент 
1Е ( 1звюреу) 
ТозегЕТеем ( "", БТеем); 
} 
уо1а СТгееМогк :: СеЕРаЕВТгее ( НТВЕЕТТЕМ БТфеш, сраг* Оче, 
сБаг* раЕЁЕег) 


сваг Епр[100]; 
сВаг +пр2[МАХ_РАТН]; 
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// получаем родительский и дочерний элементы списка 
НТВЕБТТЕМ БРагепе = СеЕРагеп® Тем ( ВТбем); 
НТВЕЕТТЕМ ЬСЬ11а = Сесср11аТкем ( БГбем); 
// если это корневой узел, путь пустой 
1Е ( БТЕем == п Огу_Вооф) 
{ 
5Егсру ( Общ, ""); 
} 
// если родительский элемент является корневым 
1Е ( ВРагепЕ == м Огу_Воо{) 
{ 
НТВЕЕТТЕМ 1®етр = МОБ; 
сваг *рб = м Огу Мане; 
1$тр = Сеесв11АТеет ( БРагер®); 
// получаем путь к элементу списка 
\211е ( 1&пр) 
{ 
1Е ( 1Ш&тр == БТеем) 
{ 
зЕгсру (про, р5); 
зЕгса® ( &тр2, РаЕЁег); 
зЕгсру ( ОцЕ, %р2)}; 
гекигп; // выходим из функции 
} 
рб += з%г1еп ({ рб) +1; 
// получаем следующий дочерний элемент 
1Етр = бесмехеТеет ( 16тр, ТУСМ_МЕХТ); 


} 
// если элемент является корневым 
е1зе 1Е ( ВТ%ем == ш_ОезКор_Воот) 
{ 
сваг Еепр [МАХ РАТН]; 
// копируем путь к папке 'Рабочий стол’ 
зЕгсру ( Еепр, м _ПезКбор Рафп); 
зегсае ( септр, "\\"); 
1Е ( зЕгстшр ( БаЕЁЕег, "") != 0) 
{ 
зЕгсаЕе ( бетшр, БаЕЕег); 
} 
Г сохраняем полученный путь и выходим 
зЕгсру ( ОаЕ, Тепр); 
гегагп; 
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е1зе 

{ 
// получаем текст элемента списка 
СеетТЕемтехе ( ВТфеш, пр, $з1хеоЁ ( бр) + 1); 


1Е ( зехсшр ( бр, "") !=0) 
{ 
зЕгсае ( бр, "\\"); 
зЕгсру ( Чар2, р); 
зЕгсаЕ ( бра, раЕЁЕег); 
5Егсру ( Оше, Ептр2); 


// ищем слудующую часть пути 
СееРаЕБТгее ( БРагепе, Оце, 00а); 


} 
// удаляем наклонную черту из пути 
1Е ( 15С511а && зЕг1ер ( Оба) >О0) 
5Егпсру ( ОаЕ, ОйЕ, 5Ег1еп ( Оаё) - 1); 


Класс СТкеейокк может с успехом применяться для решения различных за- 
дач. Для примера приведу один вариант использования, который заключа- 
ется в отображении всех файлов папки при выборе ее с помощью мыши. 
Чтобы упростить и уменьшить конечный код, вывод файлов будет осущест- 
вляться посредством стандартного списка (115 Вох), а не привычного для 
УИптао\$ списка изображений (11% Ме\,). В листинге 18.28 показан отрывок 
программы, связанный с обработкой сообщений для диалогового окна. 


Листинг 18.28. Использование класса СТгееМогк 
#1ос1аае "зЕЧаЁх.В" 

#10с1азе "СТгееМогк.В" 

// класс СТгееМогКк 

СТгееМокК могК; 

// главная функция диалогового окна 


ВООБ САШЬВАСК Му01аРгос ( НИМР Вутар19, ОТМТ пеззаде, МРАВАМ мРагап, 
ТРАВАМ ]Рагам) 


сВаг раЁЕЁЕег[300]; 

// получаем дескрипторы элементов управления 

НИМО БТгееУ1еи = МОБ, 111$%Вох = №0; 

БТгееУ1ем = СеЕр1чТеем ( Бипа01а, ТОС_МУТВЕЕУТЕМ); 

ВЬ15ЕВох = бееп1аТеет ( №ипар1д, ТОС _МУБТЗТВОХ); 

// инициализируем класс СегееМогКкК для указанного древовидного списка 
могКк. То1ЕНИМОТгее ( БТгее\У1ем); 
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// обрабатываем сообщения 
зМТЕСЬ ( пеззаде} 
{ 
// обрабатываем сообщения для древовидного списка 
сазе ММ МОТТЕУ: 
{ 
зи1ЕсЬ ( ( ( ЬРММНОВ) 1Рагам) ->соае) 
{ 
// одиночный или двойной щелчок мыши 
сазе ММ СЬТСК;: 
сазе ММ ОВЕСГК; 
// проверяем элемент управления, на котором сделан щелчок 
1Е ( ( ТОМОВО ( мРахгаш))} == ТОС МУТВЕЕУТЕМ) // наш список 
{ 
// получаем выбранный элемент списка 
НТВЕЕТТЕМ 1{ем = Тгее\У1еи бесбе1ес®1оп { ПТгее\У1ем); 
// определяем путь к этому элементу 
могКк.СесрРаеВТтее ( 1{ещ, раЕЁег, ""); 
// очищаем стандартный список 
ЗепаМеззаде ( РЪ15%&Вох, РВ ВЕЗЕТСОМТЕМТ, 0, 0); 
// выводим список файлов 
могКк.ГоааЕ11ез ( 511$ЕВох, раЕЁЕег); 
} 
ЬгеаК; 
} 
// обрабатываем специфические сообщения: для древовидного списка 
зМ1ЕСЬ ( ( 106) мРагкам) 
{ 
сазе ТРОС МУТВЕЕУТЕМ: // выделяем наш список 
{ 
ММ ТВЕЕУТЕМ *р№иТу = ( ММ ТВЕЕУТЕМ*) ]1Рагам; 
зи1Еср ( р\иту->Баг. соде) 
{ 
сазе ТУМ_ЗЕЁЬСНАМСЕР: // выбран элемент списка 
{ 
НТВЕЕТТЕМ 16ещ = ТгееУ1ем СесЗе1ес®1оп ( ПТгее\У1ем); 
уогк.СесрРаеВТгее ( 1%еш, БаЕЁег, ""); 
ЗепЧМеззаде ( №115%Вох, 1В ВЕЗЕТСОМТЕМТ, 0, 0); 
могк.ЬоааЕ11ез ( ЬТ15%Вох, БаЕЁег); 
} 
Ьгеак; 
сазе ТУМ ТТЕМЕХРАМОЕО: // разворачивание списка 
{ 
ТУ ТТЕМ 16% = р\иТу->1сепМем; 
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// проверяем состояние 
1Е (16У.зтафе & ТУГ$ ЕХРАМОЕО) 
могк.Ехрапа)т1\уез ( 1&у.БТеем, БЪ1$ЕВох); 
е1зе // удаляем элементы списка 
могк.ПБе1етеА11С611а ( 16у.БТЕем); 
} 


ргеак; 


} 
ргеак; 
сазе ММ ТУТТОТАГОС: 
// начальная инициализация списка 
могк. Тр1ЕОг1уез$ ( Вмта019); 
гебагп &гае; 
} 


тесакп Еа1$е; 


Как видите, обработка сообщений для древовидного списка не представляет 
собой ничего сложного. А теперь рассмотрим еще один не менее популяр- 
ный элемент управления, предназначенный для отображения графической и 
текстовой информации 11% Меч. 


18.2.2. Список просмотра картинок и текста 


Несмотря на то, что работать со списком просмотра даже проще, чем с Тгее 
УМе\, в книгах по программированию почему-то о нем забывают. Я поста- 
раюсь восполнить этот пробел и расскажу подробнее о работе с этим инте- 
ресным элементом. Прежде всего, следует заметить, что №5 Уе\, как пра- 
вило, используется совместно с Ппаёе 4% (список изображений). Вся ин- 
формация в 115: Ме\ может быть представлена одним из четырех способов: 
крупные значки, мелкие значки, простой список и расширенный список. 
В первых трех случаях 115: Уле\м отображает только значки и названия, а’в 
четвертом позволяет организовать для каждой записи несколько полей, ото- 
бражающих различную текстовую и графическую информацию. Этот способ 
наиболее информативен и удобен для создания небольших баз данных и для 
управления файлами. Однако перейдем непосредственно к программиро- 
ванию. 

Добавьте в редакторе ресурсов новый элемент 145 Сопёго] в окно своей про- 


граммы. Настройте свойства элемента следующим образом: в окне Уем вы- 
берите из раскрывающегося списка строчку Веротё, установите флажки 
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Это з@есНоп и Эно\ з@есНоп а№мау$. Вся остальная настройка будем вы- 
полнена нами программно. В листингах 18.29 и 18.30 показан пример клас- 
са СЕеызЕУ1еи, использующий 11% Уе\м для работы с различными фай- 
лами, 


#1ос1а4е <сописек1.В> 
// объявление класса СЕ11еЪ15&\У1ем 
С1азз СЕ11ет1$Е\У1ем 


{ 


раю11с: 
СЕ11е11зУ1еи (); // конструктор 
-СЕ11ет155\У1ем (); // деструктор 


// общие функции 
// установить дескриптор списка 
у01А беЕНапа1е!Т1зе ( НИМО 611 $%\У1ем); 
\01а Та \У1емЪ1$е (); // инициализация 
// получаем номер выбранного элемента в списке 
10е СеЕЗе1есееаТеем (); 
// возвращаем дескриптор используемого списка 
НИМО Сес\у1е\1зЕ () { гебаго м БЬ1з6У1ем; } 
// сброс переменных 
\у01А ВезееМепрег (); 
// загрузка файла в список 
у01А ОрепЕ11е (); 
ру1уафе: 
// дескриптор элемента управления 
НИМО м БЬ1$ЕУ1ем; 
// структуры для поддержки отображаемой в списке информации 
ТУ СОБИММ м _1УС; // описание столбца 
ТУ ТТЕМ м 1УГ; // описание строки 
// дескриптор для списка изображений 
НТМАСЕРТУТ м В3па11; 
10 м 1{ет; // счетчик элементов в списке 
__ 10664 м Е512е; // размер файла 
// закрытые функции 
// загрузка иконки файла. в список 
у01А ТюааТсопЕ11е ( 106 1паех, 1пЕ 1соп, сВаг* РабП); 
// вывод данных о файле в список 
уо1а ОцЕЕ11еТо1$е ( сБаг* Е1]1е); 
// определение размера файла в байтах 
__ 40664 СбекЕ11е512е64 ( спаг* Е11е); 
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// получение имени файла из пути 
уо1а СееЕг1]еРкомРаев ( стаг *Рафп, сраг *Е11е); 
}; // окончание класса 





‚Листинг 18.30. Файл РИе $ Мем.с 








#10с1а4е "зеааЁх.в" 
#$1ос1а4е <зЪе11ар1.в> 
#1пс1а4е <Сопши1а.В> 
#1ос1аде <1о.6> 
#1ос1аде <ЕспЕ1.в> 
#1ос1а4е <зЕа1о.6> 
#10с1аае "Е11еразеУ1ем. в" 
// реализация класса 
СЕ11е 1 з&\/М1ем :: СЕПешзеУ1ем () 
{ 
п 5136 У1ем = МОБЬ; 
м ем = 0; 
м Е51хе =”0; 
п Вбща11 = МОБЬ; 
} 
СЕ11ер1зЕУ1ем :: СЕ е!1з&\У1ем () 
{ 
// удаляем из памяти список изображений 
Гладет 15 Оезегоу ( м №5ма11); 
п 5$ща11 = МО; 
} 
уо1Аа СЕ11е11зЕ\У1ем :: ЗеЕНапа1ет1$е ( НИМО Ба 5Е\У1ем) 
{ 
1Е ( ВЬ15ЕУ1ем) м ВЬ15ЕУ1ем = БЬ156\У1ем; 
} 
9019 СЕ1е11зЕУ1ем :: То1\У1ем11$е () 
{ 
1Е ( о БЬ156У1ем) гебагп; 
// обнуляем структуры 
пешзее ( &м_1УС, 0, 31теоЕ ( 1У СОШОММ)); 
пешзее ( &п УТ, 0, 312еоЕ ( Ъ\ _ТТЕМ)); 
// формируем первый столбец 
м_1уС.мазк = БУСЕ ТЕХТ | ТУСЕ_ЗОВТТЕМ | ТУСЕ МТОТН; 
м_1УС.сх = 200; // ширина в пикселах 
п 1УС.рз2ТехЕ = Т ( "Ее Маме"); // название 
п 17С.1545Т6ем = 0; // порядковый номер 
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// вставляем первый столбец в список 
11з(\У1ем Тпзеге Солт ( м ВТазЕУ1ем, 0, &м _1\С); 
// формируем второй столбец, 
м _19С.сх = 150; 
м 1УС.рз2Техе = Т ("Ее 512е"); 
м 1%С.154ю [ем = 1; 
// вставляем второй столбец в список 
1 зЕУ1ем ТпзегеСо1аип ( м БЫ зЕУ1ем, 1, &м 1%С); 
// формируем третий столбец 
м _1\С.сх = 400; 
м _1\УС.рз2ТехЕ = _Т ( "Ее Рафв"); 
м _1УС.1$5 Тем = 2; 
// вставляем третий столбец в список 
13 У1ем_ТпзегЕСо1п ( м Ва зЕУ1ем, 2, &м 1%С); 
// создаем список изображений ( иконок) 
м |5та11 = Гладер1$& Сгеафе ( СеебузкетМеег1с$ ( $М СХЗМТСОМ), 
СесбузеетМеег1с$ ( $М СУЗМТСОМ), ТЬС СОБОВ | ТЬС МАЗК, 1, 1); 
} 
106 СЕет1з&У1ем :: бесбе1есееяаТеем () 
{ 
1Е ( | БЬ156У1ем) гебогпт 0; 
гебакп 1156У1ем СесмехетЕем( м НЬ1зеУ1еи, -1, БУМТАШ | 
ТУМТ_5ЕБЕСТЕО); 
} 
У01А СЕ11е1т1$ЕУ1ем :: ТоаЯТсопЕ1]е ( 11 1п4ех, 1пе 1соп, сВаг* Рай} 
{ 
1Е ( о 5Ь156У1ем) гебагп; 
ЗНЕТЬЕТМЕО з511ТоЕо; 
НТСОМ ВТсоп = М№ОШЬ; 
2егоМешогу( &501ТпЕо, 312ео0Е ( ЗНЕТЬЕТМЕО)); 
// получаем значок для указанного файла 
ЗНбееР11еТрЕо ( Рафп, 0, &351ТоЕо, 312еоЕ ( ЗНЕТГОЕТМЕО), ЗНСЕТ_ТСОМ 
| ЭЗНСЕТ_ $5МАБШИТСОМ); 
БТсоп = $51ТоЕо.БТсоп; 
// добавляем значок в список изображений 
Тпадер1зе Ааатсоп ( м В$ма11, ЮТсоп); 
// устанавливаем список изображений для списка 
1152У1ем бесТпадер 1$ ( м Б115%У1ем, м В5та]11, ТУЗТЬ 5МАТГ); 
// определяем свойства вставляемого значения 
п 1УТ.пазк = ТУТЕ ТЕХТ | ТУТЕ ТМАСЕ | ТУТЕ ЭТАТЕ; 
м 1\Е.зтабе = 0; 
м 1УТ. зсабеМазк = 0; 
м 1УТ.1Гладе = 1соп; 
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т 1уТ.1Теем = 1раех; 

м 1УТ.15о6Теем = 0; 

// добавляем элемент в список 

1156/1ем ТпзегеТеем ( м РЬ15&\У1ему, а 1УТ); 
} 
уо1а СЕ11е13&\У1ем :: ВезееМепнюег () 
{ 


Тиадет 132 Ветоуе ( м Юбща]11, -1); 
п 1еем = 0; 
м Е512е = 01; 
п №3ма11 = МОБ; 
} 
У01А СЕ11е11з&У1ем :: ОрерЕ11е () 
{ 
СВаг* 32Е1146ег = _Т ("АШП Е11ез (*.*)\0*.*\0\0"); 
сВаг з=Раен [МАХ_РАТН]} = ""; 
ОРЕМЕТЬЕМАМЕ оЕЁ; 
// определяем тип открываемых файлов 
?егомМемоку ( &0Ё, з1хеоЕЁ ( ОРЕМЕТЬЕМАМЕ)); 
ОЕ. 156кисЕ51хе = $12еоЁ ( ОРЕМЕТЬЕМАМЕ); 
оЁ. пВипаОитег = м Ва 5У1ем; 
оЁ. 1рзЕгЕ11е = з;РаеВ; 
ОЕ. ПМахЕ11е = з12еоЁ ( з;Ра®); 
ОЕ. 1рзЕгЕ114ег = 32Е11%ег; 
ОЁ. Е1ад$ = ОЕМ НТРЕВЕАРОМТУ | ОЕМ_РТЬЕМОЗТЕХТЗТ; 
// вызываем диалог для открытия файла 
1Е ( СекОрерЕ11]еМате ( &оЕЁ)) 


ОЧЕЕ11еТо115Е ( оЁ. 1рзегЕ11е); 


} 
%У01а СЕ11ет1$ЕУ1ем :: ОцЕЕ11еТо11$6 ( сваг* Ге) 
{ 
1Е ( м ВЫ з%У1ем) гебагкп; 
сраг 32Е11еМаше [100]; 
сраг $3251хе[30]; 
// загружаем значок файла в список 
Ъоа9ТсопЕ11е ( м 15еш, м 16ет, Ее); 
// выделяем имя файла из пути 
СееЕ11еЕгомРаей ( Е11е, $2Е11еМате); 
// записываем имя файла в первый столбец списка 
Т15Е\1ем ЗесТеешТехе ( м 11з\У1ем, щ 1{ет, 0, 52Е11еМане); 
// определяем размер файла в байтах 
ш_Е512е = беёг11е517е64 ( Е11е); 


Глава 18. Элементы управления 633 


// форматируем значение размера файла 
эрелпёеЕ ( з7512е, _Т ( "%1"), м Е512е); 
// и записываем во второй столбец списка 
Ъ1з5У1ем бе ТфешТехе ( м №15 У1ем, м_1еш, 1, 52512е); 
// записываем путь к файлу в третий столбец списка 
Т156У1ем беекешТехе ( м 11 зУ1ем, м_1$ет, 2, Ее); 
// увеличиваем счетчик файлов в списке 
м 16ем ++; 
тм Е51те = 05; 
} 
__ 110664 СЕ11еЬ1зУ1ем :: бефЕ11е512е64 ( сйаг* Е11е) 
{ 
1716 Ё1 = 0; 
_ 410664 164 = 0; 
// открываем файл 
Е ( (Е = ореп ( Р11е, _0 ВРОМЬУ | _0 ВТМАВУ)) != -1) 
{ 
// определяем размер файла 
164 = _Е11е1еп9е6164 ( Е1); 
_с105е ( Е1); 
тебатгп 164; 
} 
тевагп ог; 
} 
Уо1Я СЕ11ет15&У1ем :: бефЕ11еЕготРаЮ ( стаг *Ра В, сваг *Е1]е} 
{ 
// получаем указатель на строковое значение пути 
сраг *рб = Ра®В + 5%г1]еп ( Ра); 
// обрабатываем строковое значение для пути 
\111е ({ р$ > Рай) 
{ 
1Е ( *рб == ';:' || *рб == '\\') 
{ 
р$++; 
ргеак; 
} 
р5--; 
} 
// сохраняем имя файла 
зЕгсру ( Ее, р3); 


Теперь рассмотрим, как можно применить класс сЕ11ет1зЕУ1ем в своей про- 
грамме. Как и прежде, мы будем использовать диалоговую функцию в каче- 
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стве основной функции окна. В листинге 18.31 показан отрывок из про- 
граммы, в котором открытые файлы загружаются в список 115 Мех. 


$10с1о4е "зЕааЁх.В" 

#1пс1аае "Е11еразеУ1ем.6" 

// класс СЕ11ер1зЕУ1ем 

СЕ11 ел 5ЕУ1ем Е1%9; 

// главная функция диалогового окна 

ВОО САБЬВАСК Мур]1аРгос ( НИМР Вупар1а, ОТМТ пеззаде, ИМРАВАМ мРагам, 
ТРАВАМ 1Рагат) 


// получаем дескриптор списка 
НИМР ВТ зЕУ1ем = МОБ; 
215 У1ем = Сбеер]1аТеем ( Вмпар19, ТОС МУБТЗТУТЕМ); 
// обрабатываем сообщения 
5и1ЕсЬ ( меззаде) 
{ 
сазе ММ ТМТТЬОТАЬОС: 
// указываем дескриптор списка 
Е] у.5еЕНапа1е113е ( БТА з&\У1ем); 
// инициализируем список 
Е] у. плеч зе (); 
тебагп Егае; 
} 
сазе ММ СОММАМР: 
// если нажата кнопка открытия файла, обрабатываем сообщение 
1Е ( ГОМОВР ( мРагаш) == ТРОС ОРЕМЕТЬЕ) 
{ 
// открываем файл и заносим в список 
Е1у.ОрепЕ11е (); 
тефаги фкце; 
} 
БгеаКк; 
тебогп ЁЕа15е; 


В рассмотренном примере предполагается наличие кнопки для открытия и 
загрузки файла в список. Сначала мы записываем в наш класс дескриптор 
элемента управления [1% Уе\, а затем инициализируем список. Далее, 
пользуясь кнопкой открытия файла (например, трс ОРЕМЕТЬЕ), загружаем 
любой выбранный файл в список. Каждая запись состоит из трех частей: 
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имя файла, размер файла и полный путь к файлу. При необходимости вы 
можете самостоятельно добавить различные функциональные возможности. 


18.2.3. Окно свойств 


Окно свойств (Ргорему Зее) является идеальным элементом управления 
для создания как инсталляционных приложений, так и обычных программ, 
работающих по принципу пошагового выполнения (мастера). Мы рассмот- 
рим первый вариант использования данного элемента и напишем простую 
программу установки, но прежде я хотел бы объяснить главный принцип 
организации окна свойств. Он состоит в том, что несколько отдельных не- 
зависимых диалоговых окон размещаются на общем родительском окне, но 
одновременно доступен только один из них. Каждое дочернее окно имеет 
свою оконную функцию, в котором обрабатываются как собственные сооб- 
щения, так и сообщения родительского окна. На этом построено взаимо- 
действие между родительским и дочерними окнами. 


Прежде всего, нам понадобится создать основной каркас программы, кото- 
рый будет играть роль фонового. В листинге 18.32 показано, как это нужно 
сделать. 


Листинг 18.32. Создание каркаса для программы установки 





пс] аае "з6даЁх.В" 

#1ос1аае <з61953.6> 

#1пс10ае <зВЁЕо1аег.В> 

Н1ос1аае <ргзВе.В> 

носфаае <И1тпаа1.6> 

// глобальные переменные 

Н]МЭТАМСЕ ВТп$е = МОШ; 

// набор цветов для градиентной заливки 

епт 

{ 

пКея = 164, пбгееп = 45, пВ1ае = 189, 

пКеЯ2 = 225, пбгееп2 = 174, пВ1ще2 = 236 

}; 

// глобальные функции 

ВООТ, Тр1{Арр11са®1оп ( НТМ$ЗТАМСЕ ЮТпз®); 

ВООТ, Тит МА паойТпзва11 ( НТМУТАМСЕ ВТазЕ, апе 15Ъом); 

ТОМС АРТЕМТВУ Ма1иИпаРгос ( НИУМР, ОТМТ, ОТМТ, ТОЮС); 

%01А ЕаЧеУегЕ1са1 ( НИМЬ Ю\пЯ, СОЪОВВЕЕ С1:1, СОЬБОВВЕЕ С1:2, 11% пХ1, 
и бевы ПУ, 11 0х2, ле пуУ2); 

у01А ОцеТехЕ$сгееп ( НИМР Ю\па, НОС ВРС, ВЕСТ Вес®); 
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// функция И1тМа1п 
106 АРТЕМТВУ М1пМа1п ( НУМУТАМСЕ РТпзфапсе, НТАЗТАМСЕ ВРгеуТпзфапсе, 
ТРЗТВ 1рСспа1пе, 1пе пСиЯ$Вом) 


М5С мзд; 
В]п$Е = ВТлзфапсе; // копируем дескриптор программы в переменную 
// инициализируем окно программы 
1Е ( 'То16Арр]1саф1оп ( БТпзвапсе)) 
хефохгп ( ГАЬЗЕ); 
// инициализируем дополнительные элементы управления 
Тл1 ЕСоптопСоп®ко15$ (); 
// создаем основное окно программы 
1Е ( '!ТоыЕИ1паомчТрз6а11 ( БТозапсе, пСиа5бВом)) 
хебогп ( ЕАЬЗЕ); 
// запускаем цикл обработки сообщений 
\11е ( сеЕМеззаде { &159, МОБ, 0, 0)) 
{ 
Тгапз1афемеззаде ( &159); 
21зрафсЬМеззаде { &1549); 
} 
тебоги ( п59.мРагам); 
} 
ВОО Тп1Арр11са®1оп ({ НТМ5ТАМСЕ ВТпзбапсе) 
{ 
ИУМОСТА$ 5 мс; 
петмзее ( &мс, 0, з1хеоЕ ( ИМОСЬА$$)); 
// определяем параметры основного окна программы 
ис.з6у1е = С5 УВЕШВАМ | С5_НВЕПВАИ; 
// определяем оконную функцию 
мс, 1рЕПИпПаЯРЕОСс = ({ ИМОРВОС} Ма1пМпаргос; 
мс, СЬС1$Ехега = 0; 
мс.сь\мпавхека = 0; 
ис.ВБТпзбапсе = ВТлз$апсе; 
мс.ВТсоп = Ш; 
ис.ПСихзог = МО; 
ис.ВЬгВаскКакоипа = ({ НВВОЗН) СОГОВ_ВАСКСВОЧМЬ; 
ис .1рз;МепоМате = МОБ; 
// указываем уникальное имя класса окна 
мс. 1рз2С1аззМаще = ТЕХТ { "МуТп$$а11С1а$5"); 
// регистрируем наш класс окна в системе 
хебогп ( Вед1зфехС1азз ( &мс)); 
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ВОО Тр ЕМ1паомТптзеа11 ( НТАУТАМСЕ ЮТпзфапсе, 106 пСиа5ром) 


{ 


} 


НИМО Б\паМа1и; 

// создаем окно на весь экран 

БипаМа1п = Стеафей1идомЕх ( $5 ЕХ_ СОМТВОЬРАВЕМТ, 
ТЕХТ ( "Му1п3$а11С1а$5"), ТЕХТ ( "Гл5$а11 Му Ргодгам"), 
\$ РОРИРИТМРОЙ, СМ ОЗЕБЕЕАОПТ, СМ ОЗЕРЕЕАОГТ, 9999, 9999, 
Сеерезкеори1паом (), МОШЬ, ВТозбапсе, М); 

// если окно не создано, возвращаем ошибку 

ЗЕ ( 'Б\МоаМа1п) 

теЕагп ( ГАТЗЕ); 

// выводим окно на экран дисплея 

ЭЗВомИ1паом ( ЮипаМалт, пСпа$ром); 

// обновляем окно 

Ордафем1ипаои ( ВМпаМа1пт); 

тегагп ( ТВОЕ); 


// главная оконная функция программы 
ТОМС АРТЕМТВУ МазпИпаРгос ( НИМР Бипа, ОТМТ пеззаде, ОТМТ мчРагам, 


ТОМС 1Рагат) 


РАТУТЗТВОСТ рз; 
НОС Вас = мы; 
ВЕСТ Весе; 
// обрабатываем сообщения 
зи1Еср ( шеззаде) 
{ 
сазе ММ СВВАТЕ: 
// отображаем окно в развернутом виде 
ЗромИ1паои ( БИпа, $М _ЗНОИМАХТМТРЕР) ; 
тебаги 0; 
// можно оставить обработку системного меню 
сазе ИМ ЗУЗСОММАМР : 
зм1Еср ( мРагаш & ОхЕЕЕО) 
{ 
сазе $С_СТОЗ$Е: 
РозЕОи1Меззаае (0); 
ЬгеаКк; 


ЧеЁао1*: 
ргеак; 


} 


ргеак; 
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// перерисовываем окно с градиентной заливкой 
сазе ММ РАТМТ: 
// начинаем рисование 
Рас = Вед1пРа1п® ( В\ра, &рз); 
// получаем размеры клиентской области окна 
СеЕС11епЕВесе ( ВИпа, &гВес®); 
// рисуем градиентную заливку 
ЕаЯеУегЕ1са1 ( ИМоЯ, ВСВ ( пВеЯ, пбгееп, пВ1ое), 
ВСВ ( пКеЯ2, пбгееп?, пВ1ае2), ( 110) Весе.Кор, ( 106) Весф.1еЕЁЕ, 
( 106) Весе.тлаве, ( 106) Весе.БоЕбом); 
// проверяем область вывода и освобождаем контекст 
\Уа11ЧазеВесе ( ЬМпа, мощ); 
ЕпЯРа1п® ( В\па, &рз); 
// завершение работы программы 
сазе ММ _ПРЕЗТКОУ: 
Роз{Ос1ЕМеззаде (0); 
Ьгеак; 
// все остальные сообщения обрабатываются здесь 
ЧеЁао1%: 
тебогтп ( РеЕМ1паомРгос ( В\па, меззаде, мРагаш, 1Рагам)); 
} 
тесакп (0); 
} 
// функция градиентной заливки по вертикали 
уо14 ЕадеуУегЕ1са1 ( НИМО Бипа, СОЬОВВЕЕ С1:1, СОГОВВЕЕ С1т:2, 1пЕ пХ1, 
106 пуУ1, лоб пхХ2, 11 пу2) 


НВВО$Н ЮВгозр, ЮВга$ВТир; 

НРЕМ ПРеп, ПРепТир; 

НРС ВРС = МО; 

СОГОВВЕЕ с1+Тир1, с1уТир2; 

ВЕСТ Вес®; 

106 1, 1Тофа1; 

ЯодЬ1е геЯ1, геа2, геЯСаггепе, дгееп1, дгееп?, дгеепСаггепе, Ь1ае1, 
Ь11е2, Ю1аеСиггепе, ге, дгееп, Ю1ае; 

// получаем компоненты цвета 

геЯ1 = СеевУа1ае ( Со1ог1); 

дтееп1 = СеесуУа1ае ( Со1от1); 

Ю]ает = СеЕвВУа1ае ( Со1ог1); 

геЯ2? = бесвуа1иае ( Со1от2); 

дгееп2 = СефбУа1ае ( Со1ог2); 

©]ае2 = беЕВУа1ае ( Со1от2); 

// вычисляем размер по вертикали 

1Тофа1 = пу2 - пт + 1; 














Глава 18. Элементы управления 639 


// корректируем среднее значение цветов 


геЯ = ( геЯ2 - геа1) / ( 1Тофа1 - 1); 
дгееп = ( дгееп2 - дгееп1) / ( 1Тоба1 - 1); 
Б]иае = ( Б1ае? - Ю1ще!1) / ( 1Тоба1 - 1); 


// сохраняем текущие значения цвета 

теЯ@Сиггепе = геа1; 

атеепСаггепе = дгееп1; 

Б]аебСиггепе = Ь11е1; 

// получаем контекст устройства и размеры области рисования 
ИОС = бееос ( Випа); 

сееСс11епЕВесе ( Ю\па, &Вес®); 

// записываем текущие значения цвета 


с1гТир1 = ВСВ ( ( 108) геаСоггепе, ( 118) дхеепбСаггепе, 
( 116) Б1аеСаггеп®); 
с1гТир2 = ВСВ { ( 11) геаСоггепе, ( 116) дгеепбаггепе, 


( 106) Ю1еСиггеп®); 

// рисуем заливку 

Рог (1 = п\УТ1; 1 <= пУ2; 1++) 

{ 

1Е ( (1 <= Вес®.Бобвом) && (1 >=0)) 
{ 

// создаем логические перо и кисть 
ПРеп = СгеафкеРеп ( Р$_$ОЪТО, 0, с1гТир1); 
ИВгазВ = Сгеа®ебо119ВгозВ ( с1уТир2); 
// устанавливаем их для рисования 
БРепТир = ( НРЕМ) Зе1есОБЗесе ( ВРС, ВРеп); 
ЮВгазРТир = ( НВВОЗН) $е1есеОб)ес® ( ВРС, ИВга$и); 
// рисуем прямоугольник 
Весфапа1е ( ВРС, пХ1, 1, 1х2, 1+1); 
// освобождаем ресурсы 
Ре1есе0ю)есе ( ВРепТир); 
Ре1ефеоБЗесе ( ВВга$ВТир); 
// сохраняем новые значения цветов 
теЯСагтеп® += гей; 
дгеепСиггепе += дгееп; 
Ь]аеСаггепе += Бе; 


} 

// устанавливаем прозрачный фон 

ЗеЕВКМоае ( ЮБС, ТВАМ$РАВЕМТ); 

// выводим на зкран текст 

ОцЕТехЕбсгееп ( В\па, ЮРС, Вес®); 

// восстанавливаем параметры контекста и освобождаем ресурсы 
Ве1еазерС ( В\па, в5С); 
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Бе1ефеоБ]есе ( ВРеп); 
Бе1ефе0Б)есе { НВкозН)}; 
// перерисовываем окно 
Тпуа11Часевес® ({ ПИпа, 0, Еа1зе); 
} 
// функция для отображения текста на зкране 
У01А ОцЕТехе5схееп ({ НИМО В\па, НОС ВРС, ВЕСТ Вес+) 
{ 
// имя программы 
ТРСТЗТВ 1р52МамеРгоа = ТЕХТ ( "Му Ргодгаша 5.1.0"); 
// авторские права на программу 
ТРСТЗТВ 1рз7Сору = ТЕХТ ( "Сорука две (С) 2004 Му Сомрапу, Ца."); 
5фа&1с НРОМТ ЬРопё; 
з$аё1с ГОСЕОМТ 1Е; 
у = 0; 
// обнуляем структуру ГОСЕОМГ 
бегоМетогу ( &1Е, з12еоЕ ( ТОСРОМТ)); 
// определяем размер экрана по вертикали 
у = СесзузкетМеех1сз ( 5М СУЗСВЕЕМ); 
// определяем параметры шрифта 
1Е.1ЕМе1аьЕ = ЕМ ВОГО; 
1Е.1ЕНелаве = 48; 
13Егсру ( 1Е.1ЕРасемаше, ТЕХТ ( "Аг1а1")); 
// создаем шрифт 
БРопе = СгеахеРопеТпа1кесе ({ &1Е); 
// выбираем созданный шрифт, выводим на экран теневой текст 
Зе1есеОБ)есе { НОС, ВГоп®); 
ТехеОце ( ВОС, Кесе.Еор + 30, Весё.1еЁЕ + 30, 1рз2Мапе, 
156х1еп {( 1рз7Мапе)); 
// выводим на экран текст переднего плана 
БРоПЕ = СхеафегопЕТпЧ1кесе ( &51Е); 
бе1есеОБ)есе ( ВОС, ВГоп®); 
Зее ТехеСо1ок { ВОС, ВСВ ( 255, 255, 0)); 
ТехЕОчЕ ( ВОС, Весё.Фор + 32, Весе.1еЕЕ + 32, 1рз2Мапе, 
1$&г1еп ( 1р5з72Маще)); 
// выводим на экран авторские права 
1Е.1ЕНетове = 16; 
БРопе = СгеафеРопеТп1гесе ( &1Е); 
Зе1есеОБдесе { ВОС, ВРГопЕ); 
ТехеО0Е {( ВОС, Весе.Фор + 30, убсгееп - 30, 1рз2Сору, 
1$6х1еп {( 1рз2Сору)); 
// удаляем ресурс шрифта 
Ре1ефеоБ)есе ( ВЕоп®); 
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Теперь у нас получился каркас программы, на фоне которого будет работать 
программа установки. Для приближения к профессиональным пакетам ин- 
сталляции была добавлена возможность градиентной заливки и вывод ин- 
формации на экран. Следующим шагом будет создание диалоговых окон и 
окна свойств. В редакторе ресурсов создайте необходимое число одинако- 
вых по размеру диалоговых окон (для примера будет использовано три диа- 
лога). В свойствах каждого диалога установите следующие опции: выберите 
из списка стиль СВИЁ@ и тип рамки Тит, установите флажки ТШе Ваг и 
ПбаМед. Добавьте в исходный код (предполагается, что существует один 
общий файл программы) оконные функции для диалогов и функцию созда- 
ния окна свойств, как показано в листинге 18.33. Сразу замечу, что в коде 
представлены только вносимые изменения, а остальная часть пропущена 
(см. листинг 18.32). Первый диалог будет служить лля приглашения к уста- 
новке программы. Второй позволит пользователю ознакбмиться с лицензи- 
ей и сделать выбор, а третий диалог начнет непосредственно инсталляцию 
программы на компьютер пользователя. Самостоятельно вы можете доба- 
вить промежуточные диалоговые окна (например, для выбора папки). Пер- 
вый и третий диалоги оформите по своему усмотрению, а на второй добавь- 
те поле редактирования (установите флажки МшИте, Уег_са зсгоЙ, Ногп- 
200421 зсгоЙ, У/апЕ гешги и Кеад-ощу) и два переключателя (Кадю ВиНоп) 
для выбора пользователя (согласен или не согласен). Кроме этого, напиши- 
те текст лицензии и сохраните его в текстовый файл. С помошью редактора 
ресурсов добавьте этот файл в ресурсы своей программы. 


Листинг 18.33. Создание окна свойств 





// объявляем диалоговые функции 

ВООГ, АРТЕМТВУ Ме1сомер1а ( НИМР, ОТМТ, ОТМТ, ТОМ№С); // приветствие 

ВООТ, АРТЕМТВУ Г1сепзер1а ( НИМО, ОТМТ, ОТМТ,; 10№); // лицензия 

ВООТ, АРТЕМТВУ Тпзфа11019 ( НИМБ, ОТМТ, ОТМТ, Ъ0М№б); // установка 

// функция создания окна свойств 

106 СгеабеМ1хага ( НУМР В\ра, НТМЗТАМСЕ №Тпз); 

// функция настройки страниц свойств 

уо1а Е11]Раде( РВОРЗНЕЕТРАСЕ*, 1пЕ, ГРЗУТВ, ОЬСРВОС); 

// функция обработки событий для окна свойств 

116 САБЪВАСК РгорРгос ( НММР ргорр1а, ОТМТ оМ5за, ТРАКАМ 1Рагам); 

// функция обработки нажатия кнопки Сапсе1 

роо1 С11сКСапсе1 ( НИМР В\па); 

// функция загрузки текста лицензионного соглашения 

106 ТоаЯ!1сепзе ( НИМО ВЕа1{); 

// добавляем функцию СгеабеМ12ага в общий код программы 

ТОМС АРТЕМТВУ МалпипЯРгос ( НИМО ВИпа, ОтТмМТ щеззаае, ОТМТ мРагам, 
ГОМ@ 1Рагам) 
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{ 
// 
// обрабатываем сообщения 
5\1ЕсЬ ( шеззаде) 
{ 
сазе ИМ СВЕАТЕ: 
// отображаем окно в развернутом виде 
Зпоми1паоюм ( Б\па, $\М_ЗНОИМАХТМТЕЕО); 
// рисуем окно свойств 
Сгеасей1хата ( Мпа, 1Тп5%); 
гебаги 0; 
// .. 
// все остальные сообщения обрабатываются здесь 
ЧеЁал1 $: 
тераги ( РеЕМ1пдомРгос ( Ипа, пеззаде, мРагаш, 1Рагам)); 
} 
тебикп (0); 
} 
// функция создания окна свойств 
10 Схеафей1хага ( НИМРЬ ВИпа, НТМУТАМСЕ ВТп5$%) 
{ 
// определяем структуры окна свойств 
РКОРЗНЕЕТРАСЕ рзр[4]; // всегда на 1 больше числа диалогов. 
РВОРЗНЕЕТНЕАРЕВ рз|; 
// заполняем страницы свойств 
Е11]ТпРгорегеуРаде ( &рзр[ 0], ТРР МЕБСОМЕ, ТЕХТ ( "Ме1сопме"), 
Ме1сомер1а); 
Е111ТиРгорегеуРаде ( &р5р[1], ТОР ТТСЕМЗЕ, ТЕХТ ( "Г1сепзе"), 
Т1сеп5ер14); 
Е11]ТпРгорегеуРаде ( &рз$р[2], ТРО ТМ5ТАЬЬ, ТЕХТ ( "Веаду Тпзфа11"), 
Тпзфа11р1а); 
// заполняем заголовок для окна свойств 
рзЬ.Чи512е = з12еоЕЁ ( РВОРЗНЕЕТНЕАРЕК); 
рэн.9мЕ1ач$ = Р5Н_РВОРЗНЕЕТРАСЕ | РЗН_УТОАВР | Р$Н_МОАРРТУМОМ | 
РЗН_ОЗЕСАШВАСК | РЗН ОЗЕНТСОМ; 
рзВ.БиупЧРагепе = Випа; 
// заголовок окна свойств 
рзВ.рз2СарЕ1оп = ( ГРЗТВ) ТЕХТ ( "Тпзфа11 Му Ргодгаии"); 
рэН.пРадез = 512еоЁ ( рэзр) / 312еоЕ ( РВОРЗНЕЕТРАСЕ); 
// функция обработки событий для окна свойств 
р$В.рЕпСа ПЬасКк = РгорРгос; 
// загружаем иконку, предварительно сохраненную в файле ресурсов 
РзЮ.НТсоп = ГоаЯТсоп ( БТпзе, МАКЕТМТВЕЗООВСЕ ( ТРТ МУТСОМ))}; 
рэВ.ррзр = ( .РСРВОРЗНЕЕТРАСЕ) &рзр; 
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// создаем окно свойств 
тебагп ( РгорегеубБеее ( &рэВ))}; 
} 
01а Е111Раде( РКОРЗНЕЕТРАСЕ* рз, 1пе 1019 ТО, Т1РЗТВ 1ртЁ\1е, 
ОТСРВОС рЕпр1ча) 


рз->ам51хе = з1хеоЕ ( РВОРЗНЕЕТРАСЕ); 
рз->АмЕ1адз = 0; 
рз->БТизбапсе = В!л$%; 
// идентификатор диалога, созданного редактором ресурсов 
рз->рз2Тепр1а&е = МАКЕТМТВЕЗО0КНСЕ ( 19013_То); 
рз->рз2Тсоп = МОБЬ; 
// указатель на диалоговую функцию 
рз->рЕп0]аРгос = рЁп01а; 
// заголовок страницы 
рз->рз2Т1Ее = 1рт+1е; 
рз->1Рагам = 0; 
} 
// функция обработки событий для окна свойств 
11Е САБЫВАСК РгорРгос{ НИМО ргорр1а, ОТМТ аМза, ГРАВАМ 1Рагам) 
{ 
// если нужно, обрабатываем сообщения окна свойств 
зи1ЕсВ ( 9 Мз9} 
( 
сазе РЗСВ РВЕСВЕАТЕ: // окно свойств должно быть создано 
ргеакК; 
сазе РЗСВ ТМТТТАБТ2ЕО: // инициализация окна свойств 
ргеак; 
} 
тебсагп ТВОЕ; 
} 
// первое окно программы установки 
ВООТ, АРТЕМТКУ Ие]сопер1а (НИМОЬ ВО]а, ОТМТ пеззаае, ОТМТ мчРагам, 
ТОМС 1Рагам) 


// обработка сообщений 

зм1еср ( пеззаае} 

{ 

сазе ММ ЗНОМИТМРОЙ: 
// центруем окно свойств на экране 
Ра} очСепеег ( 019); 
ргеак; 
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сазе ММ МОТТЕУ; 
{ 
ТРММНОВ 1рпи = ( ЬРММНОВ) 1Рагам; 
// обрабатываем сообщения страницы свойств 
зи1ЕсЬ ( 1рпм->соае) 
{ 
сазе РЗМ КТЬТЪАСТТУЕ: // страница закрывается 
// устанавливаем возвращаемое значение 
ЗееИзпаомЬопа ( №019, ПМ МУСВЕЗОЬТ, ЕАПЗЕ}; 
гебагп ТВОЕ; 
сазе РЗМ ЗЕТАСТТУЕ: // инициализация страницы свойств 
// делаем активной кнопку МехЕ 
РгорбрееЕ Зе М12Виекопз ( СесРагепе ( В019), РЗИТ2В МЕХТ); 


ргеак; 

сазе РЗМ ИТ2МЕХТ: // нажата кнопка Мехе 
ргеак; 

сазе РЗМ ИТ2ВАСК: // нажата кнопка Васк 
ргеак; 


сазе РЗМ ВЕЗЕТ: // окно свойств будет закрыто 
ргеак; 
сазе РЗМ АРРЬУ: // нажата одна из кнопок: ОК, Арр1у, С1озе 
Ьгеак; 
сазе РЗМ ОЦЕВУСАМСЕГ: // нажата кнопка закрытия окна свойств 
1Е ( С11сКСапсе1 ( 6019) == Еа1зе) // нажата кнопка отмены 
{ 
// устанавливаем возвращаемое значение 
Зе\1паомопя ( №014, ОИЬ М$СВЕЗОЬТ, ТВОЕ); 
} 
е1зе // завершаем программу 
{ 
Роз Ои1{Меззаде {0}; 
тесогп ЕАЬЗЕ; 
} 
тебоагп ТВОЕ; 


ргеак; 
Чегао1%: 

тесагп ГАГЗЕ; 
} 
тегагип ТВОЕ; 
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// функция обработки нажатия кнопки Сапсе] 
Боо1 С11СсКСапсе1 ( НИМО Випа) 
{ 
3Е ( МеззацеВох ( Б\па, "Для отмены установки нажмите кнопку Отмена.", 
ТЕХТ { "Установка"), МВ ТСОМОЦЕЗТТОМ | МВ ОКСАМСЕГ | МВ_ОЕЕВОТТОМ) 
== ТОСАМСЕБ) 


геогр &гие; // завершить установку программы 
} 
гесагп Еа1зе; // продолжить установку программы 
} 
// второе окно программы установки 
ВОО АРТЕМТВУ 11сепзер]а ( НИМО №019, ОТМТ пеззаде, ОТМТ мРагам, 


ТОМС 1Рагам) 
{ 
НИМО БЕЗ1е = МОБ; 
// обработка сообщений 
5и16ср ( пеззаде) 
{ 
сазе ММ МОТТЕ\: 
{ 
ТРММНОК ]рпим = ( ТРММНОВ) 1Рагап; 


// обрабатываем сообщения страницы свойств 

з\ЗЕСЬ ( 1рип->соае) 

{ 

сазе РЗМ_ЗЕТАСТТУЕ: // инициализация страницы свойств 
// делаем активной кнопку Васк 
Ргорбпее® Зе М12Виесопз { бесРагепе ( №019), РЗМТАВ ВАСК); 
// получаем дескриптор окна ввода 
ВЕа1 = ( Сесо]аТкем ( 2014, ТОС МУЕРТТ)); 
// загружаем текст лицензионного соглашения 
Тоа913сепзе ( ВЕа1е); 
// устанавливаем начальное состояние радиокнопок 
СвескВаЧ91оВие оп ( 0019, ТОС _УЕ$, ТОС МО, ТОС м0); 


ргеак; 
сазе РЗМ ОЦЕВУСАМСЕЬ: // нажата кнопка закрытия окна свойств 
3Е { С11сКСапсе1 ( 019) == Ёа1зе) // нажата кнопка отмены 


{ 
// устанавливаем возвращаемое значение 
ЗееМ1пдом1юпа (5019, РИЬ МЗСВЕЗОШТ, ТВОЕ); 
} 
е]1зе // завершаем программу 


{ 
РозЕОи1ЕМеззаае (0); 
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тегагп РАГЗЕ; 


} 
гегагп ТВОЕ; 


ргеак; 
// обрабатываем сообщения кнопок 
сазе ИМ СОММАМП: 
{ 
зи1Еср ( НТМОВО ( мРагам) ) 
{ 
сазе ВМ СЬТСКЕО: // нажата кнопка 
// устанавливаем состояние кнопки Мехе 
1Е ( БОМОВР ( мРагам) == ТРОС _УЕЗ) 
// включаем кнопку МехЕ 
РгорбВее<_5еЕИ17Вис®опз$ ( СесРагепе ( В019), РЗИМТЕВ_ВАСК | 
РЗИТ2В МЕХТ); 
е1зе 1Е ( ТОИОВЬ (мРагам) == ТОС №) 
// выключаем кнопку Мехе 
РгорбпВее{ Зе М1"Восеопз ( сесРагепе ( №019), 
РЗИТОВ ВАСК); 


ргеак; 


ргеак; 
Аегаз1%: 

гегагп РАГЗЕ; 
) 
гесагп ТВОЕ; 


} 


// функция загрузки текста лицензионного соглашения 
зпЕ Роаа1сепзе ( НИМО БЕа1е) 
{ 


// ищем в ресурсах модуля программы текст лицензии 
НЕЗВС Бг11с = Е1п9Везосгсе { СеМоао1еНапа1е ( МОЬЬ), 
МАКЕТМТВЕЗО0ВСЕ { ТОК ТС), ТЕХТ { "ТХТ ТМЕО"} }; 
1Е ( ВЕБЗс == МОБ) // если не найден 
гекагп -1; // выходим из функции 
// загружаем найденный ресурс в память 
НСЪОВАГ ВС]ора]1 = 1оа@Везоигсе ( СеМода]еНапЯ1е ( МОЪ), Бес); 
1Е ( №Сб1оБа1 == МОБЬ) // если не удалось загрузить ресурс 
тебагп -1; // выходим из функции 
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// фиксируем ресурс в памяти 
ТРУОТО ]рЁВзс = ТоскКВезоцгсе ( №С1офа1); 
1 ( 1р8зс == МОЫ,) // если ошибка 


геЕагп -1; // выходим из функции 


// выводим текст в окно редактирования 
Е ({ ЗепаМеззаде ( ВЕЧЕ, ММ ЗЕТТЕХТ, 0, ( ТРАВАМ) 1рВзс)== ЕАШЗЕ) 


тесаги -1; // если ошибка, выходим из функции 


гебагп 1; 


} 


// третье окно программы установки 
ВОО АРТЕМТВКУ Тпз&а110149 ( НИМО №014, ОТМТ пеззаде, ОТМТ иРагам, 


ТОМС 1Рагам) 
// обработка сообщений 
УС ср ( пеззаде) 
{ 
сазе ИМ МОТТЕУ: 
{ 
.РММНОВ 1рпя = ( ТРММНОВ) 1Рагам; 


// обрабатываем сообщения страницы свойств 
зиТЕСВ ( ]рип->соае) 
{ 
сазе РЗМ ЗЕТАСТТУЕ: // инициализация страницы свойств 
// делаем активными кнопки Васк и Е1п1 36 
Ргорбнеее Зе И12=Ваекопз ( бееРагепе { №014), РЗИТАВ_ВАСК | 
РЗИТ2В _ЕТМТЗН); 
Ъгеак; 
сазе РЗМ МТРЕТМТ$Н: // обрабатываем нажатие на кнопку Е1п15В 
// устанавливаем программу 
ЗееарРгоагам ({); 
// завершаем программу установки 
РозЕОи1(Меззаае ({ 0); 
тесагп ГАБЗЕ; 
сазе РЗМ ОПЕВУСАМСЕТ: // нажата кнопка закрытия окна свойств 
1Е ( С11СКСапсе] ( р019) == Ёа]1зе) // нажата кнопка отмены 
{ 
// устанавливаем возвращаемое значение 
ЗеЕеИзпаомТопа (1019, ОМЬ М5СВЕЗОГТ, ТВОЕ); 
} 
е1зе // завершаем программу 
{ 
Роз&Оо1&Меззаае (0); 
гтебагп КАГЗЕ; 
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тесагп ТВОЕ; 


Ргеак; 
ЧеЁао1*: 

тееагп ЕАГЗЕ; 
} 
тебагп ТВОЕ; 


Вот у нас и получилась полноценная заготовка для инсталляции любой про- 
граммы на компьютер. Функция зееарРгодгат приведена условно для ими- 
тации процесса установки. Ее вид целиком зависит от программиста и мо- 
жет содержать функции распаковки и копирования файлов, создание ярлы- 
ков и регистрацию в системном реестре. В любом случае, ставилась задача 
изучения работы с окном свойств, и она успешно выполнена. 


На этом я, к сожалению, должен завершить рассмотрение элементов управ- 
ления. Многое осталось не сказанным, но даже приведенный в этой главе 
материал существенно поможет вам в повседневной работе. 


ГЛАВА 19 


Программирование оболочки 


Думаю, читатель со мной согласится, что УЛп4о\з, несмотря на все свои 
недостатки, является достаточно сложной и многокомпонентной операци- 
онной системой. Естественно, для поддержания ее в рабочем состоянии не- 
обходимы специальные модули и библиотеки, которые в свою очередь со- 
держат многочисленные функции и интерфейсы. Было бы странным, если 
бы создатели этой операционной системы не позаботились о предоставле- 
нии программных средств доступа к ее широким возможностям. На данный 
момент фирма М!сгозой предлагает разработчикам десятки функций и ин- 
терфейсов, позволяющих обращаться напрямую к системе, а также пользо- 
ваться ее внутренними сервисами и компонентами. Поскольку программи- 
рование оболочки является составляющей частью интерфейса \Ип32 АРТ, 
мы рассмотрим в этой главе некоторые особенно интересные и полезные 
инструменты. 


19.1. Функция ЗРе/Ехесше 


Сначала я хотел бы поговорить о наиболее часто применяемой в програм- 
мах функции $ъе1]Ехесике. Она позволяет открывать, просматривать, редак- 
тировать или выводить на печать различные зарегистрированные (имеющие 
запись в системном реестре) в У!т4о\5 типы файлов. Фокус универсально- 
сти данной функции предельно прост: извлекается необходимая информа- 
ция из реестра и загружается программа, поддерживающая указанный тип 
файлов. Здесь же и кроется один серьезный недостаток, который связан с 
выводом на печать выбранного файла. Не каждая программа содержит в 
себе код работы с принтером, и, следовательно, она не сможет распечатать 
файл, несмотря на то, что зарегистрирована в системе для работы с этим 
файлом. 


Эта функция имеет шесть аргументов, часть которых обычно не нужна. 
Первый аргумент определяет дескриптор родительского окна. Второй аргу- 
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мент указывает на тип выполняемой операции (открыть, редактировать, 
просмотреть, печатать). Третий позволяет назначить имя файла или папки, 
для которой будет выполнена требуемая операция. Четвертый аргумент по- 
могает задать параметры командной строки для выполняемого файла (на- 
пример, ЕХЕ). Пятый помогает определить имя каталога по умолчанию, а 
шестой управляет режимом отображения окна (свернутое, развернутое 
скрытое). Для успешной компиляции программы подключите к проекту 
файл зПеПар!.П. Примеры работы с функцией зъе11Ехесиее показаны в лис- 
тинге 19.1. 


#1пс]оае <зре]]арз.рВ> 

// открыть страницу в сети Интернет 

Зпе1]Ехесиее ( МОШЬ, "ореп", "Беер: //мим .МумерРаде. сом", МОБЬ, МОШЬ, 
ЗИ ЗНОИМОВМАТ) ; 

// открыть текстовый файл, расположенный в текущей папке программы 

ЗВе11Ехесоее ( МОБЬ, "ореп", "Веадту. хе", МОБ, МОБЬ, $М ЗНОММОВМАТ) ; 

// вывести на печать файл Иога из текущей папки 

ЗВе1]Ехесиее ( МОБ, "ргзпе", "Босимепе.Чос", МОБ, МО, 
$\ ЗНОММТМТМТ2ЕЪ); 

// найти папку М11Чом$ на корневом диске 

Зре1]Ехесоёе ( МОБ, "Еша", "с:\\М1п9оиз", МОБЬ, МОБЬ, $И НТРЕ); 

// просмотреть папку И1п9омз 

ЗВе11Ехесаее ( МОБ, "ехр1оге", "с:\\и1пдомз", МОШ., МО, 
$ _ЗНОИМОВМАТ) ; 

// написать письмо 

.РСТУТВ 1рМа11 = "та116о:МуВох@зегу1се. сом?зиар]ес&=Апекаое \ 

&сс=МуВох@зегу1се. сом"; 

ЗВе1]Ехесоее ( МОБЬ, МОШ., ]рМа11, МОБЬ, МОШ., $И_ЗНОИМОВМАГ); 

// запустить программу из текущей папки 

ЗВе]]Ехесисе ( МОШ.,, МОБЬ, "МуРгодгапи.ехе", "-тусоптапа", МОБ, 
ЗИ _ЗНОММОВМАЬ); 

// просмотреть графический файл 

Зпе11Ехесиее ( МОШ,, "ореп", "а: \\Ивадез\\рг1со1.6ир", МОБЬ, МОШ,, 
$ _ЗНОИМОВМАЬ) ; 


Кроме основной ФУНКЦИИ 5Ъе11Ехесибе, существует ее расширенный вари- 
ант, именуемый 3пе11Ехесибекх. Отличается она, прежде всего, дополни- 
тельной поддержкой свойств объектов СОМ. Рассматривать ее мы не будем, 
поскольку в большинстве случаев вполне достаточно возможностей базовой 
функции. 
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19.2. Диалог выбора каталога 


Следующим шагом изучения оболочки будет программирование системного 
диалога, позволяющего просматривать структуру каталогов и выбирать путь 
к определенной папке. Данный диалог идеально подходит для установки 
пути, используемого в дисковых операциях (например, сохранение файла в 
указанную пользователем папку). Чтобы облегчить себе задачу в дальней- 
шем, построим класс со1у\У\1ем, поддерживающий диалоговое окно просмот- 
ра каталогов. Пример реализации этого класса показан в листингах 19.2 и 
19.3. 





ЗАрстаде <з51о53.6> 
// объявление класса 
с1аз5 СОзгУзем 
{ 
раб]: 
СО1т:Узем (); // конструктор 
^СО1тУ1еи {() { } // пустой деструктор 
// общая функция для вывода диалога на экран 
роо1 ЗромВгомзе ( НИМО БРагепе, сраг* рафБ, сопз® сраг* +11е, 
306 1Го1аег); 
}; // окончание класса 


: Листинг 19.3. Файл Ои\ем.срр 





#1пс1а4е "зЕаафх.Ь" 
{1пс1аае "Р1хУ1ем. в" 
// реализация класса СОзг\Узем 
Со Зем :: СОмА/ем () // пустой конструктор 
{ 
} 
// функция вывода диалогового окна 
Боо1 СРагУ1еи :: ЗрВомВгомзе ( НИМО РРагепе, срВаг* рае, 
сопзЕ сВаг* &161е, зпе зРо]4ег) 


ТРМАЦГОС рМепогу; 

// получаем указатель на интерфейс 1Ма11ос 

1Е ( ЗОССЕБОБЕР ( ЗНбе&Ма]1ос { &рМепогу))) 

{ 
// указатель на структуру идентификатора для найденного каталога 
ТРТТЕМТОЬТ$Т р1еепрезЕ = МОБЬ; 
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// указатель на структуру идентификатора для исходной папки 
ТРТТЕМТОГТЗТ рзепКоо® = МО; 
// результат операции 
роо1 ЮВеза] = ЁЕа1зе; 
// временный буфер 
ТСНАВ &тр[МАХ_РАТН + 1]; 
// обнуляем буфер 
?егоМеногу ( тр, МАХ РАТН + 1); 
// если задана начальная папка, получаем ее идентификатор 
3Е ( зГо1аег) 
ЗНбеебрес1а]Ео]Чегоса®1оп ( БРагепе, 3Ко]14ег, &р1{епнВоо®); 
// определяем параметры структуры ВВОИЗЕТМЕО 
ВВОИЗЕТМЕО ргомзе; 
// обнуляем структуру перед использованием 
2егоМетогу ( &Югомзе, з1хеоЕ ( ВВОИЗЕТМЕО)); 
// заполняем поля структуры 
Ьгоизе.пипаОтег = НРагепе; // дескриптор родительского окна 
ргомзе, 1рз2Т11е { ТРСТУТВ) &11е; // текст заголовка 
Бгомзе.р191Воо®е = р]еепВоое; // идентификатор исходной папки 
Ьгоизе.рз?01зр1ауМаме = пр; // буфер для хранения пути 


// флаги для управления диалогом 
Ргомзе.01Е1а9з = ВТЕ РОМТСОВЕГОМПОМАТМ | ВТЕ ВЕТОВМОМЬУЕЗОТВ$ | 
ВТЕ ВЕТОВМЕЗАМСЕЗТОВ$ ; 
// вызываем функцию оболочки для просмотра каталогов 
рфепрезе = ЗНВгомзеГогРо1Аег ( &югомзе); 
// если нажата кнопка Сапсе], выходим из функции 
ЮВезо1% = ( рубет0езе != МОБЬ); 
ЗЕ ( ЮВеза1®) 
{ 
// если нажата кнопка ОК, получаем путь к выбранной папке 
$гу 
{ 
ЗНбеЕРа®ВЕгом1013е ( р1бетОезе, раЕП); 
} 
саёсв (. . .) 
{ 
ЮВеза1{ = #а1зе; 
} 
// освобождаем ресурсы 
рМешогу ->Егее ( р16еп0ез*)}; 
} 
// освобождаем выделенную память 
ОМепогу->Ве1еазе (}; 
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хебаги ЮВези1; 
} 


хефогп ЁЕа1зе; // ошибка 


Для реализации класса ср1хУзен мы задействовали несколько функций обо- 
лочки, а также интерфейс 1ма11ос, позволяющий правильно распределить 
системную память. Основной функцией является $НВгоизегогЕо14ег, прини- 
мающая в качестве единственного аргумента указатель на структуру 
ВВОИЗЕТМЕО. В структуре определяются все основные параметры диалогового 
окна. Если задана начальная папка, с которой начнется просмотр (в нашем 
случае можно задавать только системные папки), вызывается функция 
ЗНбее5рес1а1Ро1ЧехТоса от. Она получает. специальный идентификатор 
папки (с5т0:). Полный список существующих идентификаторов можно най- 
ти в документации к \!1132 АРТ. После того как пользователь сделал свой 
выбор и нажал кнопку ОК, применяем функцию ЗНбеЕрРаепЕкото11 5+, в0з- 
врашающую путь к выбранной папке. Как видите, все довольно просто. По- 
смотрите примеры работы с классом со1хузе», представленные в листин- 
ге 19.4. 





#1псфаае <$51о0).6> 

// переменная для хранения пути к папке 

сваг разв [МАХ_РАТН]; 

СО1 хуем 41; 

// открываем окно по умолчанию 

Ч1к.5ЗпомВгомзе ( МО, раб, "5е1есе Го1аег", 0); 

// выбираем только из доступных логических дисков 

91х.ЗВомВгомзе ( МО, раёВ, "Зе1есЕ Го]аег", С5ТРЬЬ РОВТУЕЗ); 

// выбираем только из доступных сетевых дисков 

91г.ЗВомВгоизе ( МОШ,, раёВ, "$е1есе МекРо]Аег", С$ЗТОЬ МЕТЧОВК); 


Для того чтобы открывать не только системные, но и любые доступные на 
компьютере папки, придется немного усложнить класс ср1х\/1ем. Во-первых, 
необходимо будет добавить обработку системных сообщений для диалогово- 
го окна просмотра каталогов, а во-вторых — добавить открытую функцию, 
задаюшую требуемый путь. Как это сделать, показано в листингах 19.5 и 19.6. 


#1осТтаае <з51о5).6> 


// объявление класса 
с1азз СО1хУ1ем 
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{ 
рУа611с: 
СР1хУ1ем (); // конструктор 
-СО1кУ1ем () { ) // пустой деструктор 
// общая функция для вывода диалога на экран 
Боо1 ЗромВгомзе ( НИМО БРагепе, сваг* рабР, сопзЕ сваг* &11е, 
106 1Ро1аег); 
// расширенная функция вывода диалогового окна 
Боо1 ЗРомАпуВкомзе ( НИМР БРагепр®е, сраг* рафП, соп5® сраг* &1е, 
оо? БРеЁао1{ Рав); 
// функция для установки пути к открываемой папке 
у01А ЗеёГо1аег ( сопзЕ сваг* РаЕМ); 
ре1уаее: 
// функция для обработки события ВЕЕМ ТМТТТАБТ2ЕО 
Уо1Я Тп161а112е () сопзЕ; 
// функция для обработки события ВЕЕМ ЗЕЪСНАМСЕР 
уо1А Зе1СвапдеЯ ( сопзЕ ПРТТЕМТРЬТУТ р141) сопз%; 
// статическая функция обратного вызова 
5а{1с 1пЕ __569са11 ВгомзеСа11 (НИМР Рупа, ОТМТ чМзд, ГРАВАМ ]Рагап, 
ТРАКАМ 1ррафа); 
// идентификатор родительского окна 
НИМ м В\па; 
// текущий выбранный путь к папке 
сраг м_$25е101г [МАХ _РАТН]; 
// указатель на использование текущего пути к самой программе 
роо1 ш РБеЕац1+Раеи; 
}; // окончание класса 


Листинг 19.6, Файл Оп\Мем.срр для расширенного класса Ср1т:У3еч 


$1пс1оае "зЕЧаЁх.В" 
$31пс1оае "Ра хУзем.в" 
// реализация класса СР1х\У1ем 
СР1кУЗ1ем :: СО1хУ1ем () // пустой конструктор 
{ 
м ВИпа = №1; 
ш БОеЁао1ЕРаЕр = Ёа1зе; 
зЕссру( м 525е101г, ""); 
} 
// функция для установки текущего пути 
у0о1а СО1к\У1ем :: ЗееРо14ег ( сопз$Е сраг* Раб) 
{ 
// если строка не содержит путь, выходим 
1Е ( зЕх1еп ( РабЪ) < 3) гебаги; 
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// иначе сохраняем указанный путь 


} 


з&гсру ( м 325е101г, Рабр); 


// функция вывода диалогового окна 
Боо1 СБ1ту\У1ем :: 5помВгомзе ( НИМО БРагепе, сваг* рафВ, 


сопзЕ сНаг* $141е, 1р0Е 1Ро1аег) 


Ъ.РМАБТОС рМепогу; 
// получаем указатель на интерфейс 1Ма11ос 
1Е ( ЗОССЕЕБЕР ( ЗНСеЕМа11ос ( &рМетохгу))) 


{ 


// указатель на структуру идентификатора для найденного каталога 
ТРТТЕМТОЬТЗТ р1%6етбез® = МОБ; 
// указатель на структуру идентификатора для исходной папки 
ТРТТЕМТОЬТ$Т рубептВоое = МОШ;; 
// результат операции 
Боо1 ЮВези1+ = Ёа1зе; 
// временный буфер 
ТСНАВ &пр[МАХ_РАТН + 1]; 
// обнуляем буфер 
бегоМетогу ( +пр, МАХ РАТН + 1); 
// если задана начальная папка, получаем ее идентификатор 
1Е ( 1Ро1аех) 
ЗНсеЕ$рес1а1Го1ЧехТоса 1от ( ПРагепе, 1Го14ег, &р1ещКоое); 
// определяем параметры структуры ВВОМЗЕТМЕО 
ВВОИЗЕТМЕО Бгоч5е; 
// обнуляем структуру перед использованием 
2егоМетогу ( &Бгомзе, з12еоЁ ( ВВОИЗЕТМЕО)); 
// заполняем поля структуры 
Рхомзе.БипЧО\техг = ПРахгепе; // дескриптор родительского окна 
Ьгомзе. 1р52Т141е = ( ТРСТЗТВ) &1Е1е; // текст заголовка 
Бгомзе.р1Я1ВооЕ = р1фепВоо{; // идентификатор исходной папки 
Бгомзе.рз201зр1ауМате = пр; // буфер для хранения пути 
// флаги для управления диалогом 
Бгомзе.и1Е1ад5 = ВТЕ РОМТСОВЕГОМРОМАТМ | ВТЕ ВЕТОВМОМЬУЕЗЬОТВ$ | 
ВТЕ ВЕТОВМЕЗАМСЕ$ТОВ$; 
// вызываем функцию оболочки для просмотра каталогов 
р1$етрезе = ЗНВгомзеЕРогГо]1А4ег ( &Бгомзе); 
// если нажата кнопка Сапсе1, выходим из функции 
ЮВезо1Е = ( р1бетрезе != МО); 
1Е ( БВеза{) 
{ 
// если нажата кнопка ОК, получаем путь к выбранной папке 
$гу 
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ЗНсееРаеВЕгошТРТ156 ( р16бептОезе, рафп); 
} 
саесь (...) 
{ 
ЬВези1% = Еа1зе; 
} 
// освобождаем ресурсы 
РМемоку ->Ргее ( р1%епрез®); 
} 
// освобождаем выделенную память 
рМепогу->Ве1еазе (); 
гебагп ЮВези1; 
} 
хебагп Еа1зе; // ошибка 
} 
// расширенная функция вывода диалогового окна 
Боо1 СО1кУ1ем :: ЗВомАпуВгомзе ( НИМО ВРакгепёе, спаг* рав, 
сопз& спаг* &1]е, Боо1 БОеЁаи1ЕРаеп) 


Боо1 БВезо1Е = Ёа1зе; 
ГРТТЕМТЬГТЗТ р1а1; 
ВВОМЗЕТМЕО Ьгочзе; 
// обнуляем структуру перед использованием 
2егоМешогу ( &Бхтомзе, з12еоЕ ( ВВОИЗЕТМЕО)); 
// заполняем поля структуры 
Ьгоизе.ПипаОмтег = ВРагепе; // дескриптор родительского окна 
Ьгомзе.1р$2Т1461е = ( .РСТЗТВ) &141е; // текст заголовка 
Ьгоизе.р1Я1ВооеЕ = 0; // идентификатор исходной папки 
Ьгомзе.рз201зр1ауМате = 0; // буфер для хранения пути 
Ьгоизе.и1Е1адз = ВТЕ ВЕТОКМОМГУЕЗЬОТВ$ | ВТЕ ЗТАТОЗТЕХТ; // флаги 
// функция обратного вызова 
Бгомзе.1рЁп = ВгомзеСа11; 
// указатель на класс СО1к\Узем 
Ьгомзе.1Рагам = хе1пбегрге® саз<1опа> ( &115); 
// обрабатываем путь по умолчанию 
1Е ( ББеЕау1ЕРафп) ш _ЮБеЁал1ЕРабр = $гце; 
// выводим на зкран диалоговое окно 
1Е ( ( р1а1 = ЗНВгомзеРогГо]Аег ( &югомзе)) != МО) 
{ 
// если нет ошибок, получаем путь к папке 
1Е ( ЗНбеЕра&ВЕгомтОТ15Е ( р1а1, м $25е101г)) 
{ 


ЬВезо1& = сгое; 


} 


Глава 19. Программирование оболочки 657 


зЕхсру ( раёП, м_525е101г); 
} 
// если необходимо, освобождаем память 
ТРМАГЬОС рМепогу; 
1Е ( ЗОССЕЕБЕР ( ЗНСефМа11ос ( &рМепогу))) 
{ 

РМетоку->Етее ( р1а1); 

РМепогу->Ве1еазе (); 


} 

п Вира = моъь; 

// выходим из функции 
хебагр ЮВези1е; 


// функция для обработки события ВЕЕМ_ЗЕТСНАМСЕР 
уо1а СО1к\У1ем :: 5е1Срапдеая ( сопзе .РТТЕМТОЬТ$Т р1а1) сопзЕ 


{ 


} 


ТСНАВ 52СахВ1т [МАХ_РАТН]; 

// получаем текущий выбранный путь 

1Е ( ЗНСсееРа&ВЕгоютрТ15е ( ( ТРТТЕМТЫЛЯТ) р1а1, 
( ГРТЗТВ) $2Сигр1г)) 


// меняем текст в диалоговом окне 
Зеп9Меззаде ( п _П\Мпа, ВЕЕМ ЗЕТЗТАТОЗТЕХТ, 0, ({ ТРАВАМ) з2Сакр1х); 


// функция для обработки события ВРЕМ ТМТТТАЕСТРЕР 
уо1А СР1кУ1ем :: То161а11хе () сопз® 


{ 


Е ( м ББеЁац1РаЕИ) // текущий путь 
{ 
ТСНАВ $201: [МАХ _РАТН]; 
// получаем путь к текущей папке 
1Е ( сесСиггепеб1хескоку ( з1теоЁ ( $201.) / з1хеоЕЁ ( ТСНАВ), 
5201) ) 


// посылаем сообщение диалоговому окну 
ЗепаМеззаде ( п_ПУпа, ВЕЕМ ЗЕТЗЕТЕСТТОМ, ТВОЕ, ( ГРАВАМ) 5201г); 


} 
е1зе // выбираем путь с помощью функции Зее Ко1аег 


ЗепаМеззаде ( м ПМпа, ВЕЕМ ЗЕТЗЕТЕСТТОМ, ТВОЕ, 
( ГРАВАМ) п _525е101г); 
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Теперь наш класс позволяет указать любую доступную на компьютере (или 
в сети) папку, с которой начнется просмотр. Пример работы класса показан 
в листинге 19.7. 





Н1ос1аае <зВ1о05).8> 

// переменная для хранения пути к папке 
срахг рав [МАХ_РАТН]; 

СО1хУ1ем 91; 


// начинаем просмотр с текущей папки 

Ч1х.ЗромАпуВгомзе ( МОШ, рабв, "Зе1есе Го14ех“, Егхае); 
// указываем начальную папку, с которой начнется просмотр 
Ч1г.ЗееГо14ег ( "С:\\\1паомз"); 

Я1х.ЗПомАпуВгомзе ( МОШ., рабв, "5е1есЕ Го14ехг", Еа15е); 


Думаю, здесь все понятно, и можно переходить к следующей теме. 


19.3. Диалог для открытия файлов 


Одним из незаменимых компонентов оболочки является набор стандартных 
диалоговых окон, решающих следующие задачи: открытие и сохранение 
файлов, выбор шрифта и цвета, поиск и замена текста. Программисту пре- 
доставляются три варианта работы с этими диалогами. Первый позволяет 
просто воспользоваться готовым решением, второй дает возможность полу- 
чить доступ к внутренней структуре этих ресурсов, а третий вариант пол- 
ностью заменяет стандартный ресурс пользовательским. Как правило, для 
большинства задач вполне хватает первого варианта, однако если вам необ- 
ходимо реализовать нестандартные возможности, придется применить вто- 
рой или третий варианты. 


Сначала рассмотрим, как можно использовать базовые ресурсы системы на 
примере диалога "Открыть". Создайте класс сорепЕ11е, как показано в лис- 
тингах 19.8 и 19.9. 


#1ис1а4е <Сопиа1а.В> 

#ЧеЕ1пе СН ВОГЕЕВ ЗТ2Е 5120 // размер буфера 
#аАеЕ1пе ОР МАМЕЗТРЕТЕМ 100 // длина имени файла 
// объявление класса 

с]аз5 СОрепЕ11е 
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{ 
руЪ11с: 
// конструктор 
СОрерЕ11е ( НИМР НМа1п, сВахг* 32Е1]6ех, Боо1 ЮМи1%1); 
// деструктор 
—СорепЕ11е (); 
// общие функции 
// показать диалог для открытия файла 
уо1А* ЗромОрепЬ14 (); 
// показать диалог для сохранения файла 
уо!1А* Зромбауер]14 (); 
// получить путь к файлу 
Уо1А Сеег11еРаЕв ( сБахг* з2РафН) сопз%; 
// получить имя файла 
уо1А СееЕ11еМате ( спаг* з2Маше) сопз%; 
// получить имя первого файла 
106 СеЕЕ1кзЕЕ1]е ( свахг* 52Е11е); 
// получить имя следующего файла 
106 СбеЕМехеЕ11е ( сБаг* $27Е1]е); 
рг1уафе: 
спаг ш 32ЕР11еРафВ [МАХ РАТН]; 
спаг м $2Р11еМаше [ОР МАМЕЗТАЕЕМ]; 
сраг* м р52Е11е; 
сраг* м р57Рабп; 
ОРЕМЕТЬЕМАМЕ м оЕЁ; 
Боо1 м М1; 
9051дтеа 3пе п роз; 
уп519пеа 10 м 1еп_рафв; 
170 м 1еп; 
Боо1 м ЬЕхр1; 
}; // окончание класса 





Листинг 19.9. Файл ОрепЕНЙе.срр класса СОрепЕ11е 


#1пс1таае "зЕааЁх.В" 
#+1пс1аае "ОрепЕ11е.в" 
// реализация класса 
СОрепР11е :: СОрерЕ11е ( НИМР ЮМа1п, сВаг *32Е1]6ег, Боо1 ЬМи11) 
{ 
// инициализируем переменные 
м_52Е11еРаЕп [0] '\0'; 
м 52Е11еМаше[0] = '\0'; 
м рз2ЕР11е = МО; 
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м рз2РаёВ = МОБ; 
м №11 = БЕ; 
м роз = 0; 
м 1еп_рабВ = 0; 
м ]еп = 0; 
// если будет использоваться множественный выбор файлов, готовим буфер 
1Е (м БМ) 
{ 

// выделяем немного памяти для хранения имен файлов 

ш рз2Е11е = пеи сраг[СН ВОЕЕЕВ $17Е]; // 1024 * 5 

// если память недоступна, выходим 

1Е (м р52Р11е == МОШ.) гебогп; 

// и еще немного для хранения пути к файлам 

ш рз7РабН = пем сваг[СН_ВОРЕЕВ $12Е]; 

// если память недоступна, выходим 

1Е (м рз2РаёВ == МО) 

{ 

Че1ефе [] м рз2Ее; 
хеагп; 

} 

м рз2Рафр[(0] = МО; 
} 
// обнуляем файловую структуру 
шемзеф ( &м оЁ, 0, 517еоЕ ( ОРЕМЕТШЕМАМЕ)); 
// заполняем поля структуры 
п оЁ.136гасЕ512е = $12еоЕ ( ОРЕМЕТЬЕМАМЕ); // размер структуры 
м оЁ.ВитаОмпег = ПМа1п; // дескриптор родительского окна 
м оЁ.РТлзфапсе = 0; 
м оЁ.1рзЕхЕ1]6ег = 52Е116егз; // фильтр для выбора типов файлов 
м ОЕ. 1р5гСизбомЕ116ег = 0; 
Ш ОЕ. пМахСизЕЕ11 ег = 0; 
м ОЁ.пЕ11<егТпаех = 0; 
// если будет использоваться множественный выбор файлов 
1Е (м 6М1:) 
{ 

// используем выделенный буфер для хранения имен файлов 

м оОЁ.1рзегЕ11е = м р52ЕПе; 

ш оЕЁ. 1рз56гЕ11е[0] = МОШ; 
} 
е15е 

п ОЕ. 1рзегЕ11е = м 52Е11еРафй; 
// определяем размер выделенного буфера 
1Е (м 11) 

м ОЕ. пПМахЕ11е = СН ВОЕРЕЕВ 5Т2Е + 1; 


Глава 19. Программирование оболочки 661 


е1зе 
м оЁ.пМахЕ11е = з12еоЁ ( м 52Е11еРабИ); 
// продолжаем 
т ОЕ. 1рз&гЕ1]еТ1{41е = м 52Е1]еМале; // заголовок диалогового окна 
ш ОЕ. пПМахЕ11еТ1Е1е = 51хе0Е ( м 52Е11еМаше); 
т ОЕ. 1рё6г11161а101х = 0; 
м ОЕ. 1рзегТ1 Ее = 0; 
// определяем флаги 
тЕ (м 6Мо11) 


п оЁ.Е1ад5 = ОЕМ АБТОИМОГТТЗЕЬЕСТ | ОЕМ_НТРЕВЕАРОМГУ | 
ОЕМ ЕРТЬЕМОЗТЕХТЗТ | ОЕМ ЕХРГОВЕВ; 
е15е 
п оЕ.Е1а95 = ОРМ НТРЕВЕАРОМГУ | ОРМ_ЕТЬЕМОЗТЕХТЗТ; 


// продолжаем 

м ОЕ. ПЕ1еОЕЕзеЕ = 0; 

`м оЕ.пР1еЕхфепз1от = 0; 

м ОЕ. 1СазЕБака = 0; 

м оЁ.1рЁЕПНооК = 0; 

м ОЕ. 1рТетр1абеМаме = 0; 
} 
СОрерЕ1]е :: СОрерЕ11е () 


// освобождаем память 
1Е ( м р52Е11е) ае1ефе [] п рё2ЕЁе; 
1Е (м рэз7Рабй) Че1ефе [] м рз2Рафи; 


Уо1А* СОрерР11е :: ЗПомОрепВ1ча () 
{ 
хебиги &м_оЕЁ; 
} 
уо1А* СОрепЕ11е :: Зромбауер194 () 
{ 
тебакп &м оЁ; 
} 
у0о1А СОрерЕ11е :: СекЕ11еРафП ( сВаг* з;РафП) сопз® 
{ 
зЕгсру( з2РафВ, м _52Е1]еРафП); 
} 
уо1А СОрепЕ11е :: бееЕ11еМаше ( спахг* з2Маше) сопзЕ 
( 


5Егсру ( 52Маше, п_52Р411еМапе); 
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10е СОрепЕ11е :: сеЕёЕ1г$ЕЕР11е (сраг* з2Е1]е) 


{ 


сВаг БаЕ[МАХ РАТН] = ""; 

// если выбран не множественный режим, выходим 
1Е ( м БМ) тебого 0; 

// определяем длину буфера 

1еп = 5&х1еп ( м р57Е11е); 


// проверяем стиль окна 

м БЕхр1 = м оЁ.ЁЕ1ад5 & ОЕМ ЕХРГОВЕВ; 

// если флаг ОЕМ ЕХРТОВЕК установлен, делаем так 
1Е (м БЕхр1) 


{ 


п _1еп = СН ВОЕЕЕВ_5Т2Е; 
// выделяем общий путь к файлам 
зЕгпсру (м р57Ра&й, м рз2Е1]е, зЕг1еп ( п рз2Е1е)); 
п рз7Рабп [м оЁ.пЕ11е0ЕЕзеф-1] = '\0'; 
зЕгсаЕ ( м рз?Ра®В, "\\"); 
// получаем смещение к первому имени файла 
п роз = м оЁ.рЕ11е0ЕЁзее - 1; 
п роз++; 
ш_]еп -= п роз; 
// выделяем имя первого файла 
Еог { Ы& ) = 0; } < м 1еп; ++) 
{ 
ЗЕ (м р52Е11е [п роз] == '\0') 
{ 
зЕхсае ( м рз2Рабй, БаЕ); 
зЕгсру ( 52Е11е, ш рз2РабП); 
м _рз2РаЕН [м оЁ.пЕР11еОЕЁзее] = '\0'; 
м ]1еп_рабВ = м оЁ.пЕР11еОЕЁзек; 
м _1еп +=); 
п роз++; 
хефико 1; 
} 
БЕ [3] = м рз2Е11е [м роз]; 
ш роз++; 


} 


// если флаг ОЕМ ЕХРГОВЕВ не установлен, делаем так 


е1зе 


{ 


// если выбран один файл 
1Е (п оЁ.рЕПеЕхбепз1оп) 
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{ 
// копируем путь и выходим 
зЕгсру ( 52Е11е, м оЁ.1рзегЕ11е); 
тебагп 0; 
} 
е1зе // иначе получаем имя первого файла 
{ 
Бог ( 11 = 0; 1 < м 1еп; 1++) 
{ 
1Е ( м рз2Ее[1] == ' ') 
{ 


п рз2Раев[0] = '\0'; 
эЕгпсру (п рз2РаёН, БаЁ, зег1еп ( БаЕ)); 
п рэ7тРаев[1] = '\0'; 


БаЕ[0] = '\0'; 

п роз = 1; 

п ро$++; 

м ]еп -= 1; 

Рог (116 ) = 0; ) < м 1еп; Э++) 

{ 
1Е (м р52Ее [м роз] == ' ') 
{ 


БаЕ[5] = '\0'; 

зЕгсру ( 52Е11е, м рз2Ра®П); 
п роз ++; 

п рэгРаев[1] = '\0'; 


п _1еп раёВ = 1; 
м 1еп +=1; 
гебагп 1; 

} 

ЬаЕ[ 3] = м рэз=ЕПе [п роз]; 

п роз++; 

} 
} 
БоЕ[1] = м рз2Е1е[1]; 
} 
} 
} 


гегаги 0; 


106 СОрепЕ11е :: СеМехфЕ11е ( сВаг* з2Ё11е) 


{ 
СсВаг ЪаЁ [МАХ РАТН] =" "; 
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// устанавливаем ограничения 
1Е ( № Мот) гебаго 0; 
1Е ( э6г1еп ( м рэгРабВ) < 3) гебогп 0; 
1Е ( (м р$з2ЕШе [а_роз$]) == '\0') гебагп 2; 
// если флаг ОЕМ_ЕХРЬОВЕВ установлен, делаем так 
1Е( м ЬЕхр1) 
( 
// получаем имя следующего файла 
Бог ( 1 =0; 1 < м 1еп; 1++) 
{ 


1Е ( п роз >= м 1еп) гебогп 2; 


1Е ( п рз2ЕЁ1е [т роз] == '\0') 
{ 
1Е ( м рз2Е11е[м роз + 1] == '\0') 
{ 
эЕгса® ( п рэзгРаёВ, БаЕ); 


( 
зЕгсру ( $2Е11е, м рэ7РаЕП); 
гебагп 2; 
} 
зЕгсае ( п_рзгРа®В, БаЕ); 
ЗЕгсру ( $2Е11е, п рзтРаёИ); 
м роз ++; 
п рз2РаВ [т 1еп рафВ] = '\0'; 
геёиагп 1; 
} 
БоЕ[1] = м рз2Е11е [роз]; 
п _роз++; 


} 
е1зе 
{ 
Рог ( Ш 1 = 0; 1 < м 1еп; 14+) 
{ 
// получаем имя файла 
1Е ( м_роз >= м 1еп) гебаги 2; 
1Е ( п рэз2Е11е [п_роз] == ' *) 
{ 
БаЕ[ 1] = '\0'; 
5гсае ( м рэз2Раби, БоЕЁ); 
зЕгсру ( 32Е11е, п рэгРа®И); 
п ро5 ++; 
п _рзгРа®В [тп 1еп рафВ] = '\0'; 
гебагп 1; 
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БоЕ[1] = м рз2ЕПе [м роз]; 
п роз++; 
} 
} 


гегогп 0; 


Класс получился несколько сложным из-за того, что была добавлена воз- 
можность загрузки множества файлов, поскольку в некоторых программах 
(например, аудио- и видеоплееры) без этого просто не обойтись. Пример 
работы с классом сОрепЕг11е представлен в листинге 19.10. Для исключения 
неприятных ошибок при создании выполняемого файла добавьте в опциях 
компоновщика ссылку на библиотеку Сот 32.15. 






Листинг 19.10. Пример работы с классом СОрепЕ11е 





#$1ос10ае "ОрепЕ11е.в" 
// определяем фильтр для выбора файлов 


спаг $7Е116ег[] = Т ( "А11 Е1]ез (*.*)\0*.*\0\0"); 
// буфер для хранения пути 
СВаг з2РабВ [МАХ_РАТН] = *""; - 


// объявляем наш класс с множественным выбором 
СОрепЕР11е оЕЁ ( ЬМуМ1т4ом, 52Е11]46ег, кие); 
// выводим на экран диалог для открытия файлов 
106 1Снеск = бекОрепЕ11еМаще ( ( ГРОРЕМЕТЬЕМАМЕ) оЁ.5НомОрепо1а ()); 
// если пользователь выбрал более одного файла, обрабатываем их 
1Е ( 1СВеск != 0) 
{ 
// получаем имя и путь для первого файла 
1Е ( оЕ.СеЕЕ1т56Е11е ( з2РабВ)) 
{ 
// делаем что-нибудь с полученным значением 
// например, копируем в стандартный список 
ЗепаМеззаде ( ЮМу?15е, ТВ АБОЗТАТМС, 0, ( ГРАВАМ) 
( .РСТ5ТВ) з2РаёП); 
// выбираем оставшиеся файлы 
мВ11е (1) 
{ 
1Е ( оЕ.Себ\ехЕЕ11е ({ э;РабВ) == 2) 
{ 
1Е ( э6г1еп ( эз2Рабр) > 5) 
ЗепМеззаде ( РМу!11з%, 1В АООЗТВЕТМС, 0, ( ГРАВАМ) 
( .РСТЗТВ) з2РаёП}; 
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гегагп; // если файл последний, выходим 
} 
ЗепМеззаде ( №Мут15е, ТВ АРОЗТАТМС, 0, ( ТРАВАМ) 
( .РСТЗТВ) з2РабП); 


} 
е1зе // выбран только один файл 
{ 
// копируем его в список 
ЗепЧМеззаде ( №Му115е, ТВ АРОЗТЕАТМС, 0, ( ТРАВАМ) 
( ГРСТЗУТВ) $з2Рабп); 


В рассмотренном примере мы определили фильтр, позволяющий открывать 
любые файлы, и поддержку множественного выбора (более одного файла). 
После этого была вызвана системная функция бееОрепЕ11емапе для вывода 
на экран стандартного диалогового окна. Когда пользователь отметит от- 
крываемые файлы и нажмет кнопку ОК, в буфер э=Рафь будет помещено 
определенное значение. Если выбран только один файл, это значение будет 
содержать путь и имя файла, иначе придется применить функции се-- 
Е1гзЕЕ11е И семехеЕ11е для чтения из буфера всех имен файлов. 


Чтобы получить доступ к внутренней структуре стандартных диалоговых 
окон, придется немного изменить класс сОорерЕ11е. Нам нужно будет опре- 
делить собственную функцию обратного вызова Са11ОрерЕ11еРгос, в которой 
можно обрабатывать специальные системные сообщения для диалогов. 
Кроме того, необходимо добавить флаг оЕМ ЕМАВЬЕНООК при определении 
структуры ОРЕМЕТГЕМАМЕ. Диалоговое окно для открытия (сохранения файла) 
поддерживает следующие уведомляющие сообщения: 


О сом ЕтьЕОК — пользователь нажал кнопку ОК; 

СОМ ЕОГРЕВСНАМСЕ — пользователь открыл новую папку; 

сом НЕГР — пользователь нажал кнопку помощи; 

СОМ ТАЕТРОМЕ — завершена инициализация диалогового окна; 


СОМ _ЗЕТСНАМСЕ — выбран новый файл в открытой папке; 


ооооо 


СОМ ЗНАВЕУТОЬАТТОМ — пользователь нажал кнопку ОК и произошла 
ошибка доступа к общему сетевому ресурсу; 


С срм ТУРЕСНАМСЕ — пользователь выбрал новый тип файла в раскрываю- 
щемся списке. 


Все эти уведомления можно обработать в функции обратного вызова через 
системное сообщение мм моттЕУ. Также существует возможность переда- 
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вать диалогу стандартные командные сообщения посредством функции 


ЗепаМе5заде: 


О сом СЕТЕТЬЕРАТН — получить имя и путь к выбранному файлу; 


О срм СЕТЕОТОЕВТЬЬТ$Т — получить системный идентификатор текущей 


папки; 


О срм СЕТЕОБОЕВРАТН — получить путь для текущей папки; 


О сом нтоЕСОМТВОЕ — спрятать определенный элемент управления диалога; 





О СОМ ЗЕТСОМТВОБТЕХТ — изменить текст для указанного элемента управле- 


ния диалога, 


0 сом ЗЕТЬЕЕЕХТ — установить расширение файла по умолчанию. 


С их помощью можно не только обрабатывать выбранные файлы, но и пре- 
образить внешний вид самого диалогового окна. Перед тем как приступить 
к практике, ознакомьтесь с идентификаторами элементов управления диа- 
логового окна, показанных в табл. 19.1. С их помощью можно посылать 
командные сообщения для определенного элемента. 


Таблица 19.1. Идентификаторы элементов управления 


`Идентификатор Описание элемента управления 


ТроК 
ТОСАМСЕЬ 
рэБНе1р 
свх1 


сть1 


стог 


спо13 


1541 


ечЕ1 


581 
$Ес2 


56с3 


56с4 


Кнопка ОК 

Кнопка Сапсе! 

Кнопка Нер 

Флажок "только для чтения" 


Раскрывающийся список для отображения типов файлов (опре- 
деляется фильтром) 


Раскрывающийся список для отображения выбранного диска 
или папки 


Раскрывающийся список для редактирования имени 
открываемого файла 


Список для отображения содержимого текущей папки или диска 


Поле редактирования, отображающее имя выбранного файла 
с возможностью редактирования 


Надпись для списка 1351 
Надпись для раскрывающегося списка спь1 


Надпись для раскрывающегося списка спть13 и поля редактиро- 
вания еае1 


Надпись для раскрывающегося списка спь2 
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Теперь, когда основные теоретические сведения получены, перейдем к про- 
граммированию диалогового окна с помощью функции обратного вызова. 
В листинге 19.11 показаны изменения, которые нужно внести в реализацию 
уже созданного класса сорепЕ1ле. 





Листинг 19.11. Перехват внутренних сообщений для диалогового окна 


// исправьте конструктор класса, как показано ниже 
СОрепЕ11е ( НИМ РМа1пБ1а1о09, спаг* 52Е116егз, Юоо1 БМи1, 
роо1 БНоок = Еа1зе); 
// добавьте в конец функции конструктора следующий код 
1Е ( БНоок) // добавляем флаг ОЕМ ЕМАВЬЕНООК 
{ 
1Е (п ЮМа161) // если установлен множественный выбор 
оп. Е1адз = ОЕМ АБЪОИМОГТТЗЕБЕСТ | ОЕМ ЕМАВТЕНООК | ОЕМ ЕХРГОВЕВ 
| ОЕМ_НТОЕВЕАРОМЬХ; 


е15е 
оЁп.Е1адз = ОЕМ ЕМАВЬЕНООК | ОЕМ ЕХРЬОВЕВ | ОЕМ НТРЕВЕАРОМГУ; 
// добавляем указатель на функцию обратного вызова 
оЕп.1рЕпНоок = ( ЬРОЕМНООКРКОС) Е11еОрепНооКРгос; 
} 
е15е 


оЕп.1рЕпНоок = 0; 
// добавьте объявление глобальных функций в начало файла ОрепЕ11е.срр 
// функция обратного вызова для перехвата сообщений диалога 
ВООЬ САЪЬВАСК Е11еОрепНооКкРгос ( НИМР, ОТМТ, МРАВАМ, ТРАВАМ); 
// функция обработки специальных уведомляющих сообщений 
ВООГ МЕАВ РАЗСАТ Е11еОрепМоЕ1ЕуРгос ( НИМР №019, ГРОЕМОТТЕУ 1рМоЕ1Еу); 
// пишем реализацию этих функций 
ВООЬ САШВАСК Е11еОрепНоокРгос ( НУМО №519, ОТМТ пеззаде, ИРАВАМ иРагам, 
ТРАВАМ 1Рагам) 


// обрабатываем стандартные сообщения И1п9о\з$ 

зи1еср ( пеззаде) 

{ 

сазе ИМ ТМТТОТАТОС: // инициализация диалога 
// здесь можно устанавливать новый текст для элементов диалога 
// Зеп9Меззаде { №014, СБМ ЗЕТСОМТВОГТЕХТ, { ИРАВАМ) 3%с3, 

{ ГРАВАМ) "Имечко:"); 

// или прятать отдельные злементы 
// ЗепаМеззаде ( №019, СОМ НТРЕСОМТВОГ, ( МРАВАМ} ТООК, 0); 
// если нам понадобится указатель на структуру ОРЕМЕТЬЕМАМЕ 
Зе\и1паом опа ( ИО1а, РМЪ ОЗЕВ, 1Рагам); 
ргеак; 
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// если нужно, может изменить цвет диалогового окна 
// сазе ММ СТЬСОБОВРГС: 
// создать кисть следует заранее 
// гебакп ( 1ВЕЗОШГТ) м Вгазй; 
// обработка уведомляющих сообщений диалога 
сазе ММ МОТТЕУ: 
// вызываем функцию обработки сообщений 
ЕР1]еОрепМос1ЕуРгос ( РО1а, ({ ГРОЕМОТТЕУ) 1Рагат); 
Ьгеак; 
// закрытие окна 
сазе ММ БЕЗТВОУ: 
{ 
// если нужно, получаем указатель на структуру ОРЕМЕТЬЕМАМЕ 
ТРОРЕМЕТЬЕМАМЕ 1рОЕ = ( ТРОРЕМЕТЬЕМАМЕ) СеёМ1паАомЪопя ( ВР19, 
РИЬ О$ЕВ); 
} 
ргеак; 
} 
гегогп ЕАЬЗЕ; 
} 
// функция обработки уведомляющих сообщений диалогового окна 
ВООГ. МЕАВ РАЗСАЬ Е11]еОрепМоЕ1ЕуРтос ( НИМО ВО1а, ГРОЕМОТТЕУ 1рМов1Еу) 
( 
// определяем переменную для хранения данных 
сВаг 32Тепр[МАХ_РАТН]; 
// обрабатываем коды уведомляющих сообщений 
$м1есв ( 1р\оЕ1Еу->Ваг. соае) 
{ 
сазе СОМ ТМТТРОМЕ: // инициализация диалога 
МеззадеВох ( 1019, "Инициализация диалога.", "СОМ _ТМТТООМЕ", 
МВ ОК); 
ргеак; 
сазе СОМ_ЕТЬЕОК: // нажата кнопка ОК 
// выводим имя выбранного файла 
Ме5задеВох ( ВО1а, 1рМое1Еу->1роЕМ->1рзехЕ11е, "СОМ ЕТТЕОК", 
МВ ОК); 
ргеак; 
сазе СОМ_ГОГРЕВСНАМСЕ: // выбрана новая папка 
{ 
// получаем путь к папке, используя макрос 
1Е ( СопиО19 _ОрепЗауе_СееЕРо1ЧегРаеВ ( СефРагепе ( №0149), з7Тепр, 
51теоЕ ( з2Тепр)) <= з12хеоЕ (52Тепр) ) 
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// отображаем имя папки 
МеззадеВох ( №014, з2Темр, "СОМ ЕОГРЕВСНАМСЕ", МВ ОК); 


ргеак; 
сазе СОМ ЗЕЪСНАМСЕ: // выбран новый файл 
{ 
// выводим путь к файлу 
1Е ( Саиа019 Орепбауе_СефЕ11еРакв ( СееРагепе ( №019), э2Тепр, 
з1геоЕ ( з2Тетр)) <= э1хеоЕ ( з2Тепр)) 


МеззадеВох ( №019, з2Тетшр, "СОМ _ЗЕЪСНАМСЕ", МВ_ОК); 
} 
// выводим имя файла 
1Е ( СотО1а_Орепбаче_Се+$рес ( СбеЕРагепф ( 1019), 2Тепр, 
512е0Е ( зхТепр)) <= з12еоЕ ( 5з2Тепр)) 


Меззадевох ( №014, з2Тетр, "СОМ _ЗЕЪСНАМСЕ", МВ_ОК); 


ргеак; 

сазе СРМ _ЗНАВЕУТОТАТТОМ: // ошибка доступа к файлу в сети 
МеззадеВох ( №019, 1рМоЕ1Еу->1роЕМ->1рзегЕ11е, "Ошибка", МВ ОК}; 
Ьгеак; 

сазе СОМ НЕГР: // нажата кнопка справки 
МеззадеВох ( №О1а, "Не удалось найти файл справки", " СОМ НЕГР ", 

МВ ок); 

ЬгеаК; 

} 

гебагп ТВОЕ; 


Как видно из листинга, реализовать перехват сообщений для диалогового 
окна довольно просто. Однако следует знать, что некоторые возможности 
(изменение цвета диалога, модификация текста элементов управления и их 
отображение) не будут поддерживаться, если установлен стиль огМ_ЕХРГОВЕВ. 


Последний способ, связанный с созданием собственного диалогового окна, 
мы здесь рассматривать не будем, поскольку он имеет много общего с уже 
приведенными способами и, думаю, не создаст проблем опытному про- 
граммисту. А я хотел бы рассказать о не менее важном компоненте оболоч- 
ки — о ярлыке. 
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19.4. Создание ярлыка 


Если говорить на языке программирования, ярлык можно представить как 
ссылку на какой-либо объект операционной системы (например, на файл), 
расположенный в любом месте вашего компьютера (на одном из дисков). 
Нри щелчке мышью по ярлыку \УМш4о\$ проверяет его свойства и активи- 
зирует соответствующую процедуру обработки (например, запуск програм- 
мы на выполнение). Как правило, большая часть ярлыков сосредоточена на 
Рабочем столе и в меню кнопки Пуск, поскольку именно отсюда пользова- 
тель начинает работать с оболочкой. Несомненно, любому программисту 
рано или поздно понадобится программно создавать и размещать ярлыки 
как на Рабочем столе, так и в различных каталогах на компьютере. Мы рас- 
смотрим сам процесс создания ярлыка и несколько практических примеров 
его размещения на компьютере. 


Для поддержки ярлыков в \У!тдо\$ существует специальный интерфейс 
ТЗВе111док, с помощью которого можно легко манипулировать свойствами 
ярлыков. Также нам понадобится вспомогательный интерфейс трегзазеЕа1е, 
позволяющий загружать и сохранять различные файлы на диск. Думаю, чи- 
татель знает, что интерфейс не является классом и его нельзя вызвать на- 
прямую. Сначала нужно инициализировать библиотеку СОМ-объектов 
(функция соТп1{1а112е) и получить глобальный идентификатор (ст5тр) для 
используемого интерфейса (функция соСгеахеТпзтапсе). После этого можно 
пользоваться всеми доступными методами интерфейса, а по окончании ра- 
боты нужно обязательно освободить объектную модель СОМ (функция 
Со0п4п141а11=е). По традиции напишем специальный класс для создания 
ярлыков и назовем его, например, сток. Необходимые файлы представлены 
в листингах 19.12 и 19.13. 


Листинг 19.12. Файл ЫпК.Н класса СЪзок 


Нис1оае <зВ1о5).6> 
// определяем класс СТАтК 
с1аз5 СыпКк 


{ 


раБ11с: 
С1АтК (); // конструктор 
<С11тк () { } // пустой деструктор 


// общие функции класса 
// функция создания ярлыка на Рабочем столе 
уо1А СгеаферлкЬезКкКеор ( спаг* рз2МатеГ1пКкКЕ11е, сваг* рзхРафрпаще, 
сваг* р52Агд$, сНаг* рз2ТсопРа®И, 11% 1Тсоп}; 
// функция создания ярлыка для самой программы 
У01Я СгеасерпКТр1$ ( сваг* МапеРгодгаш, срВаг* МашеГпк, 
БМОВР омЕо1дег); 
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рг1уаее: 


}; 


НВЕЗОГТ Втез; // возвращаемое значение 

Т5Ве1111пк* рз1; // поддержка ярлыков 

ТРегз1$6Е11е* ррЕ; // поддержка файловых операций 

ТСНАВ 1р525рес1а1Ро1ЧегРаЕН {МАХ РАТН]; // путь к системным папкам 
ИСНАВ из? [МАХ РАТН]; // временный буфер 

// окончание класса 


Листинг 19.13. Файл ЫпК.срр класса сыпк 


#1пс1а4ае "зЕЧаЁх.В" 
#1остаае "Шак.в" 

// реализация класса 
СЫк :: Сок () 


{ 


} 


Вгез$ = 0; 
рз1 = 0; 
рРЕ = 0; 


у0о1А СЫшпк :: СгеакеглкБезкеор ( спаг* рзхМапе пкКЕПе, 


сваг* рз2Раббпаше, сваг* рз2Агаз, спваг* рз2ТсопРа®А, 1пе 1Тсоп) 


ТСНАВ рз2Ь1пКЕ11е[МАХ_РАТН]; 
// инициализируем СОМ 
Вгез = Со1п11а112е ( МО); 
// проверяем результат 
1Е ( ПВез != $ ОК) тебагп; 
// получаем идентификатор интерфейса ТзНе1Ппк и создаем объект 
Вгез = СоСгеаеТптзкапсе ( СЬ$ТО $Ве11ТАпк, МОШ., СЬЗСТХ_ТМРВОС_ЗЕВУЕВ, 
ТТр Т5ЗВе1 пк, ( РУОТО*) &рз1); 

// проверяем результат 
1Е ( ЗОССЕЕШЕР ({ Вгез)) 
{ 

// получаем путь к папке Рабочий стол 

1Е ( 5Нбеебрес1а1Ео1ЧегРа®В (0, 1р5$2$рес1а1Ео1ЧегРае\й, 

С5ТОЬ РЕЗКТОР, ЕАЦЗЕ)) 


// сохраняем путь к системной папке 

зЕгсру ( рз2ы1ПКЕЁ1е, 1р572брес1а1Го1ЧегРаеп); 
// создаем путь для ярлыка 

зЕгсае ( рзхЬ]пкЕ11е, "\\"); 

зЕгсае ( рзх1пКЕ11е, рзхМаме ]пкЕ11е}; 
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// определяем путь для программы, на которую указывает ярлык 


рз1->беЕРафп ( рзхРабппащме); 
// если программе нужны аргументы, добавляем их 
рз1->5е6Агаамепь$ ( р5з2Агаз); 
// определяем путь к значку для ярлыка 
р$1->5е ТсопГоса1оп ( рз”ТсопРаЕН, 1Тсоп); 
// получаем указатель на интерфейс ТРегз1зЕ11е 
Вгез = рз1->ОдегуТпеегЕасе ( ТТО ТРег$1$%Е11е, ( РУОТО*) 
// сохраняем файл ярлыка на диск 
1Е ( ЗОССЕЕБЕР ( вгез)) 
{ 
// если кодировка Ип1соЯ, преобразуем строку 
#1ЕраеЕ ОМТСООЕ 
Ми] 1ВусеТои1АеСваг ( СР АСР, 0, рз2Ы]11КЕ41е, -1, \м52, 
МАХ РАТН); 
// сохраняем ярлык 
Ргез = ррЕ->ба\уе ( изх, ТВОЕ); 
#е1зе 
Югез = ррЕ->5бауе ( рз2Ь1пКЕ11е, ТВОЕ); 
Зеро Е 
// освобождаем интерфейс ТРег$1з+Е11е 
РрЕ->Ве1еазе ()}; 


} 
// освобождаем интерфейс Т5Нел1т пк 
р$1->Ве1еазе ()}; 

} 

// удаляем СОМ 

Со0п1п1Е1а112е (); 

// обнуляем переменные 


Вгез = 0; 
р$1 = 0; 
РрЕ = 0; 
} 
%01А СТЯрК :: СгеаберлакКТЬ1$ ( сБаг* МатеРгодгам, сВаг* МатеГлк, 


ОМОВОР @мЕо]14ег) 


спаг рз?Ы1пКР11е[МАХ РАТН]; // путь к ярлыку 

сваг рз2РаЕппаще [МАХ РАТН]; // путь к программе 

саг рз2ТсопРабь [МАХ РАТН]; // путь к значку для ярлыка 
// получаем полный путь к своей программе 
СеЕМоаи1еЕ11еМаме ( МОБЬ, рз2Раппате, МАХ_РАТН); 


&ррЕ); 
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// восстанавливаем короткий вариант пути, если необходимо 
1Е ( СекбпогЕРае|Маше ( рзхРакПпате, з751огЕ, МАХ _РАТН)) 
{ 
5Еусру ( рз2Рапаще, з258ог®); 
} 
// убираем из пути имя программы 
*( зЕгкспЕ ( рзгРабппате, '\\') + 1) = '\0'; 
// создаем путь к ярлыку 
$Ехсру ( рз=ГсопРабй, рз;Расппаще); 
зЕхсае ( рз2ТсопРаёи, "\\"); 
зЕхсае ( рз2ГсопРабв, МамеРгодкат); 
// инициализируем СОМ 
Вгез = Со1п11а11те ( МБ); 
// проверяем результат 
1Е ( №Вез != $ ОК) гебагп; 
// получаем идентификатор интерфейса Тзве111]]пКк и создаем объект 
Вгез = СоСгеакеТпзеапсе ( С15Т0 $Вейтапк, МОБЬ, СЬ$СТХ_ТМРВОС ЗЕВУЕВ, 
ТТО Т5ре1111тк, ( РУОТО*) &рз1); 


// проверяем результат 
1Е ( ЗОССЕЕШБЕО ( вгез)) 
{ 
// получаем путь к указанной папке 
1Е ( СНбеббрес1а1Ео1ЧетРа®В ( 0, 1рз25рес1а]Ео1ЧетРае\, 
ЧмРо1аетг, ЕАБЬЗЕ)) 


// копируем путь 

зЕхсру ( рз2Ь1тКЕ11е, ]1рзхбрес1а1Ро]ЧегРаеи); 

зЕгсае ( рз2ЬапКЕ11е, "\\"); 

// добавляем имя ярлыка 

зЕгтсае ( рз2Р1рКЁР11е, Матеьок); 

// устанавливаем рабочий каталог 

р31->5еЕМогк1п901гесеогу ( рзгРаЕппапе); 

// устанавливаем путь к ярлыку 

5Егсру ( рз2Рабпаше, рз7ТсопРаЕИ); 

рз1->3еЕРаЕН ( рз2Ра®паше); 

// устанавливаем путь к значку 

рз1->бесТсопЬосае1оп ( р52ТсопРабИ, 0); 

// сохраняем ярлык на диск 

Вгез = рз1->ОцегуТпеегЁасе ( ТТО ТРегз156Е11е, ( РУОТО*) &ррЕЁ); 

1Е ( ЗОССЕЕШЕО ( Вгез)) 

{ 

Ми1(1ВуееТой1аеСвак ( СР АСР, 0, рэз2Ь1пКЕ11е, -1, чз, 

МАХ РАТН); 


Глава 19. Программирование оболочки 675 


Ргез = ррЕ->бауе ( мч57, ТВОЕ); 
РрЕ->Ве1еазе (); 


} 
рз1->Ве1еазе (); 


} 

// удаляем СОМ 
Со/п11161а117е (); 

// обнуляем переменные 


Вгез = 0; 
рз1 = 0; 
ррЕ = 0; 


В классе мы определили две функции: Сгеасе!окрезкЕор И СхеабешокТЬ1з. 
Первая позволяет создать любой ярлык и поместить его на Рабочий стол, а 
вторая предназначена для создания ярлыка к самой выполняемой програм- 
ме и размещения его в любой системной папке. Примеры работы с классом 
сышх показаны в листинге 19.14. 


Листинг 19.14. Примеры работы с классом Сток 





// создание ярлыка для перезагрузки компьютера 
У01А ВезбагЕ М1таом$ () 
{ 
Сарк 111К; 
ТСНАВ 1р57М1п[МАХ РАТН]; 
// получаем путь к папке с \п9омз 
1Е ( бебиатаомзО1хгескогу ( 1р$7М1п, МАХ РАТН)) 
{ 
// создаем ярлык 
5Ехсае ( 1р52М10, "\\гара1132.ехе"); 
11ок.СгеабеГлкрезКеЕор ( "ВезкахЕМ1паомз.10Кк", 1рэз2мМ1и, 
"56е1132.4911, ЗНЕХлЕМ1паомзЕх 0х2", "56е1132.911", -153); 


} 
// создание ярлыка для отображения свойств экрана 
уо1Аа ЗВо\р1$р1ауРхорег®у () 
{ 
сышк тк; 
ТСНАВ 1рз7И1п [МАХ РАТН]; 
// получаем путь к папке с И паомз 
1Е ( беби1оаомзО1тескогу ( 1рз7И1п, МАХ РАТН)) 
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// создаем ярлык 
зЕгсае ( 1р$2М1п, "\\гипа1132.ехе"); 
112К.Сгеаке.оКОезКкеор ( "015р1ау РгорегЕ1ез.1пК", ]1рз2\1п, 
"5е1132.а11,СопЕго1_ ВапрЬЬ аезК.ср1, 01зр1ау,3", "56е1132.4911", -43); 
} 
} 
// функция для создания ярлыка программы на Рабочем столе 
уо1А СгеакеброгесиЕОезк®ор ()} 
{ 
Срок Иштк; 
// создаем ярлык 
11пКк.СгеабеьлКТЬ1$ ( "МуРгодгат.ехе", "МуРгодгам.10К", 
С5ТОЬ РЕЗКТОР); 
} 
// функция для создания ярлыка программы в меню кнопки Пуск 
у01А СгеасебвогесиЕ$ СагЕМепи () 
{ 
СЫшк Пк; 
// создаем ярлык 
]1пК.СгеабешакТЬ1з ( "МуРгодгат.ехе", "МуРгодгам.1пК", 
С$ТОЬ $ЗТАВТМЕМО); 


Думаю, что представленных примеров будет достаточно для самостоятельно- 
го продолжения работы с классом сы пк. 


19.5. Процессы и потоки 


И напоследок поговорим о доступе к потокам и процессам в УЙпдо\5. Са- 
мым простым способом получения информации о текущих процессах и по- 
токах является использование функции СгеасеТоо1те1р325парзвое. Она по- 
зволяет сделать снимок текущего состояния системы. Дополнительно к ней 
применяются функции Рхгосезз32Е1гзе, Рхгосезз32Мехе, ТигеаЧЗ2Е1езЕ И 
ТЬгеаЯ932Мехе. Первые две функции позволяют найти и извлечь информацию 
о процессах, а последние две выполняют те же функции, но для потоков. 
Для описания процессов и потоков используются соответственно структуры 
РВОСЕЗЗЕМТВУЗ2 И ТНВЕАРЕМТВУЗ2. Пример получения информации обо всех 
текущих процессах и потоках показан в листинге 19.15. 


Листинг 19.15. Получение информации о запущенных процессах и потоках 





#1ос1аае "зЕЧаЕЁх.В" 
#10с1а4е <з61о.6> 
#1ос1а4е <61Бе1р32.6> 
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// пишем функцию, загружающую найденные процессы в список 
у01Я ГоааРгосез$ ( НИМО РЪ156Вох) 


{ 


// определяем информационную структуру для процесса 
РВОСЕЗЗЕМТВУЗ2 ргосЕпегу = {0 }; 

// буфер для данных 

ТСНАВ БаЁЕЁег[100] =""; 

// условие завершения поиска 

Роо1 БЕпа = Еа1зе; 

// делаем "снимок" системы 
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НАМОЬЕ Ю5парзпоЕ = СгеабеТоо1пе1р325парзНое ( ТН3З2С$_5МАРРВОСЕ$5, 0}; 


// заносим размер структуры РВОСЕЗЗЕМТВУЗ2 
ркосЕпеку.Ом51хе = з12еоЕ ( РВОСЕЗЗЕМТВУЗ2)}; 
// получаем первый найденный процесс 
БЕла = Ргосез$32Е1:3е ( Ю5бпарзроЕ, &ргосЕпЕгу}; 
// создаем цикл для перечисления всех загруженных процессов 
\211е ( БЕпа) 
{ 
// получаем имя выполняемого файла для найденного процесса 
зрг1пЕЕ ( БаЕЁег, "Р11е: %5$", ргосЕпегу. з2ЕхеЕ1]е); 
// заносим его в список 
бепЧМеззаде ( №Ь15ЕВох, ШВ АООЗТЕТМС, 0, 
( ТРАВАМ) ( ЬРСТЗТВ) БаЕЁЕег); 
// получаем уникальный идентификатор процесса 
зру1пЕЕ ( БаЕЁег, "ТО: $%5Х", ргосЕлёку.6632Ргосез$1)); 
// заносим его в список 
Зеп9Меззаде ( №115&Вох, ЪВ АРОЗТВАТМС, 0, 
( ГРАВАМ) ( ГРСТЗУТВ) раЕЁЕег}; 
// получаем значение базового приоритета 
$ре1пЕЕ ( БаЕЁехг, "Рг1ог16у: $14", ргосЕпегу.рсРг1С1а$3Вазе); 
// заносим его в список 
беп9Меззаде ( №115%Вох, ЪЬВ_АООЗТВТМС, 0, 
( ТРАВАМ) ( ЬРСТЗТВ) роЕЁЕег); 
// получаем число потоков в процессе 
зреттЕЕ ( раЕЁег, "Сомпе ТЬгеааз: %14", рхгосЕпеку.спЕТВтгеа4з); 
// заносим его в список 
бепЧМеззаде ( №15ЕВох, РВ АБОЗТВТЮС, 0, 
( ТРАВАМ) ( .РСТЗТВ) раЕЁег); 
// ищем потоки для заданного процесса 
ТоаАТЬгеаа ( №115%Вох, ргосЕпегу.ЕП3З2Ркосе$$Т0); 
// переходим к поиску следующего процесса 
БЕра = Ргосезз32№ехе ( ЮбпарзВое, &ргосЕпегу); 
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// закрываем дескриптор поиска 
С1озеНарЯ1е ( Н$парзВое); 
} 
// пишем функцию для получения потоков для указанного процесса 
уо1А ТоаЯТьгеаа ( НММО ВТ1зЕВох, ОМОВО амчРгосеззТ0) 
{ 
// определяем информационную структуру для процесса 
ТНВЕАБЕМТВУЗ2 ЕвгеаЯаЕпегу = {0}; 
// буфер для данных 
ТСНАВ БаЁЁет [100] =" "; 
// условие завершения поиска 
роо1 БЕпПа = ЁЕа1зе; 
// счетчик потоков 
12 1Мипрег = 1; 
// делаем "снимок" системы 
НАМОРЕ В$бпарзроЕ = СгеасеТоо]те1р32$парзНое ( ТН32С$_ЗМАРТНВЕАО, 0); 
// заносим размер структуры ТНВЕАБЕМТВУЗ2 
ЮтеаЧЕлегу. м512е = з17еоЁ ( ТНВЕАОЕМТВУЗ2); 
// получаем первый найденный поток 
БЕра = ТЬхеаа32Е1узе ( Н5бпарзбое, &ЕПгеадЕпегу); 
// создаем цикл для перечисления всех потоков 
\11е ( БЕла} 
{ 
// проверяем идентификатор процесса 
1Е ( ЕйгеааЕреку. В32ОутегРгосеззТР == амРгосез$Тр) 
{ 
// получаем идентификатор потока 
зри1пеЕ ( РаЕЁег, "Тигеаа %и, ТО: $%$5Х", 1Мопфег, 
{ВгеааЕпегу. ЕВЗ2ТЬгеаатр) ; 
// заносим его в список 
Зеп9Меззаде ( НЬ1зЕВох, ШВ АОБОЗТЕТМС, 0, 
( ТРАВАМ) ( ТРСТЗТВ) БаЕЕег); 
// получаем базовый приоритет потока 
зруарЕЕ ( БаЕЁЕег, "ТигеаЯ %а, Вазе Рг1ог1у: %5Х", 
1Мопрег, ЕАгеааЕпегу.ЕрВазеРг1); 
// заносим его в список 
ЗепЧМеззаде ( ЬЪ1$ЕВох, 1В_АБОЗТАТМС, 0, 
( .РАВАМ) ( ГРСТЗТВ) раЁЕег)}; 
// увеличиваем счетчик 
1№рег ++; 
} 
// переходим к поиску следующего потока 
БЕпа = ТЬгеаа32МехЕе ( ЮбпарзВое, &&ЬгеааЕпегу); 
} 
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// закрываем дескриптор поиска 
С1озеНапЯ1е ( ВЗпарзро®); 


В примере вся полученная информация заносится в список, дескриптор ко- 
торого можно получить, например, с помощью функции сеер1атеет. Кроме 
перечисления процессов и потоков, имеется возможность непосредственно- 
го управления ими: изменение приоритета и принудительное завершение 
работы. 


Каждый процесс или поток имеет определенный уровень привилегий, суть 
которого заключается в очередности доступа к процессорному времени. Бо- 
лее высокий уровень обрабатывается процессором в первую очередь. Все 
варианты уровня привилегий для процессов можно свести к четырем: низ- 
кий (ТОТЕ РВТОВТТУ СЪАЗ5), нормальный (МОВМАТ РЕТОВТТУ_ СТАЗ5), ВЫСОКИЙ 
(НТСН РЕТОВТТУ СЪАЗ5) и уровень реального времени (ВЕАТТТМЕ РВТОВТТУ_ 
сА55). По умолчанию любой пользовательский процесс получает нормаль- 
ный уровень привилегий. Если ваша задача не требует немедленного вы- 
полнения, ей следует присвоить низкий уровень, а для важных и быстрых 
вычислений можно установить высокий уровень. Присваивать процессу 
уровень реального времени не рекомендуется, поскольку это может привес- 
ти к сбою всей системы. К тому же, не следует думать, что в \Мтао\5 мож- 
но по-настоящему получить доступ к процессору в реальном времени. Это 
миф, и любая задача, связанная с реальным временем выполнения (особен- 
но на опасных производствах), должна работать с 00$, ЧШХ или с анало- 
гичными операционными системами. Чтобы изменить приоритет того или 
иного процесса, можно использовать функцию $еЕРе1от1ЕуС1азз, ОДНИМ ИЗ 
аргументов которой является идентификатор процесса. Получить его можно 
либо с помощью функции сееСогкеперкосеззэта (для текущего процесса), 
либо перечислением, как было показано раньше. В профессиональных сис- 
темах УМш4ао\з (МТ/2000/ХР/$ВЗ) следует предварительно получить права 
на доступ к системе. Как это реализуется на практике, показано в листин- 
ге 19.16. 


#1пстоаае "зЕЧаЕх.Н" 
// пишем функцию для установки приоритета 
уо1А беЕРи1охг1Еу ( ОМОКР диРгосеззТ0, ПМОВР ЭмРг1ог1 у) 
{ 
НАМОЬЕ БРгосезз = 0; // дескриптор открытого процесса 
// открываем процесс 
ВРгосезз = ОрепРгосезз ( РКОСЕЗ$ ЗЕТ ТМЕОВМАТТОМ, ЕАЬЗЕ, 
ЧмРгосез5Тр)}; 
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1Е ( БРгосезз == МО.) гебагл; // не удалось открыть процесс 
// для И1о9ом$ МТ/2000/ХР/$ВЗ устанавливаем права доступа 
1Е ( !ЗеъАссезз ( БРгосезз, амРгосезз1Тр)) 


{ 
// если не удалось получить доступ, выходим из функции 
С1озеНарЧ1е ( ПРгосезз$); 
геЕагп; 
} 
// устанавливаем приоритет 
ОМОВО ЧмВеза1е = 5ееРх1ог16УС1азз ( ПРгосезз, ЯЧмРх1ог1 у); 
// если произошла ошибка, выходим из функции 
1Е ( амВези16 == 0) 
{ 
МеззадеВох ( МОШ., _Т ( "Не удалось изменить уровень приоритета."), 
_Т ("Отчет"), МВ ок); 
С1озеНапЯ1е ( ВРгосез$); 
гебагп; 
} 
МеззадеВох ( МОШ., _Т ( "Операция успешно выполнена."), 
_Т ("Отчет"), МВ_ОК); 
// закрываем процесс 
С1озеНарЯ1е ( ВРгосезз$); 
} 
// функция для установки прав доступа 
Боо1 ЗеёАссез$ ( НАМОГЕ БРгосезз, ОМОВО амРгосе$$тТ0} 
{ 
НАМОЬГЕ ВНап9]еТокепр = МОШ; 
ТОКЕМ_РАТУЕЬЕСЕ$ пемР, сигР; 
ОМОВО @мВези1Е = $17ео0оЕЁ ( сагР); 
// открываем доступ к текущему потоку 
1Е ( '!ОрепТЬхеаЧТокеп ( беЕСиггепеТргеаа (), ТОКЕМ_АБЛО$Т_РАТУТЬЕСЕ$ 
| ТОКЕМ_ ОЧЕВУ, Еа15е, &ПНап1еТоКеп)) 


// определяем тип ошибки 
1Е ( бебтазЕЕгког () != ЕВВОВ МО ТОКЕМ) 
гебигп Еа1зе; 
// открываем доступ к текущему процессу 
1Е ( !ОрепРгосеззТокеп ( бееСаггепЕРгосез$ (), ТОКЕМ ОЦЕВУ | 
ТОКЕМ АРЗОЗТ РВТУТЬЕСЕ$, &ННарЯ1еТокКеп)) 
гееагп Еа1зе; 
} 
// заполняем информационную структуру доступа 
пемР. Рг1\11еде5 [0] .АЕЕг1риеез = 5Е РАТУТЬЕСЕ ЕМАВЬЕО; 
ремР.Рх1\У11едеСойпе = 1; 
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// определяем локальный идентификатор 
ТоокирРг1\11едеУа1ае ( МОБ, 5Е_РЕВОС МАМЕ, 
&пемР.Рх1711]едез[0].1419); 
// включаем доступ 
1Е ( !Аа)азЕТокепРкг1У11едез ( ННапЧ1еТоКкеп, Ёа1зе, &пемР, 
з1хеоЕ ( пемР), &сагР, &ЧмВези1)} 


// если произошла ошибка, выходим из функции 
С1озеНапа1е ( ВНапа1еТокеп); 
гебогп ЁЕа]15е; 
} 
// открываем процесс для завершения 
ВРгосез5 = ОрепРгосез$ ( РВКОСЕ$$ ТЕВМЕМАТЕ, Еа1зе, ЯмРгосеззТр); 
// восстанавливаем прежний уровень доступа 
АЗ) азсТокепРг1\11едез ( ННар91еТокеп, ЁЕа]15е, &сигР, 5з1теоЁ ( сагР), 
МОБЬ, МОБЬ); 
// закрываем дескриптор 
С1озеНарЯ1е{ ННапЯ1еТокКеп); 
// если не удалось открыть процесс, возвращаем ошибку 
1Е ( ЮРгосезз == МОБ) 
гебигп Еа15е; 
// выходим из функции 
гебагп &хгце; 
} 
// пример работы с функцией ЗеЕРг1ог1фу 
ОМОВО ргосез$Тр = 0; 
// получаем идентификатор текущего процесса 
ргосез$1Т0 = беЕСиггепеРгосез$ Та ()}; 
// устанавливаем высокий уровень приоритета 
ЗееРт1ог1Еу ( ргосеззТ0Ю, НТСН_РЕТОВТТУ СПАЗ$$); 


Для того чтобы принудительно завершить какой-либо процесс, следует вос- 
пользоваться функцией ТетгизпасеРхосезз. Кроме того, для профессиональ- 
ных систем потребуется установить права доступа. Пример функции завер- 
шения процесса представлен в листинге 19.17. 





// пишем функцию завершения работы процесса 
уо1а К111Ргосез$ ( ОМОВО амРгосез$Т0, Боо1 БТЗМТ) 


{ 
НАМОГЕ БРгосез$ = МЫ; 
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// определяем тип системы 
Е ( ЮТЗМТ) // Изтаом$ МТ/2000/ХР/$ВЗ 
{ 
// открываем процесс 
ВРгосезз = ОрепРгосезз ( РКОСЕ$$ ТЕВМТМАТЕ, Га1зе, ЧмРгосез5Тр); 
1Е ( ПРгосезз$ == МОШ) геблаип; 
// устанавливаем права доступа 
1Е ( '!ЗебАссезз ( ВРгосезз, ЭиРгосеззТр)) 
{ 
// если не удалось получить доступ, выходим из функции 
С1озеНапа1е ( ПРгосез$); 
теги; 
} 
// пытаемся завершить процесс 
©оо1 ЮВезо1Е = ТегилпафеРгосезз ( ЮРгосезз, ( ИТМТ) -1); 
// если результат равен 0, произошла ошибка 
1Е ( !0Везо1е) 
{ 
С1озеНалЯ1е ( ВРгосез$); 
гебагп; 
} 
// закрываем дескриптор 
С1озеНапЯ1е ( ЮРгосез$); 
} 
е15е // \М1паомз 95/98/МЕ 
{ 
// открываем процесс 
ВРкосезз = ОрепРгосезз ( РВОСЕЗ$ АБ АССЕЗ$, Еа1зе, ЧиРгосез$10}; 
1Е ( ВРгосез5 == МО.) гебаги; 
// пытаемся завершить процесс 
роо1 ЮВеза1Е = ТегилпасеРгосезз ( ИРгосезз, ( ОТМТ) -1); 
// если результат равен 0, произошла ошибка 
1Е ( '!ЮВези1) 
{ 
С1озеНарЯ1е ( ВРгосез$); 
гебауп; 
} 
// закрываем дескриптор 
С1озеНапа1е ( ВРгосез$); 
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Как видите, завершить процесс довольно просто, однако это не всегда по- 
лучается. Иногда для лучшего эффекта имеет смысл сначала завершить от- 
крытые потоки внутри процесса (если их больше, чем один), а потом за- 
крыть и сам процесс. Для завершения потока применяется функция 
Теги пасеТЬгеаа, первый аргумент которой представляет собой дескриптор 
потока. Его можно получить из функции орептьхеаа. Кроме того, потоки 
также поддерживают уровень доступа, установить который можно, вызвав 
функцию зектьгеаарк1ог1еу. Общий принцип работы с отдельными потока- 
ми мало отличается от управления процессами, поэтому эту тему я оставлю 
для самостоятельного изучения читателям. 


ГЛАВА 20 


Работа с файлами 


В этой главе мы познакомимся с программированием файлов в операцион- 
ных системах УИпао%$. Как ни странно, но многие книги практически не 
затрагивают данную тему, хотя она, по моему мнению, является базовой для 
любого программиста. Мы рассмотрим три основных темы: 


1. Общие принципы работы с файлами. 
2. Сжатые файлы. 
3. Шифрование файлов. 


20.1. Общие принципы 


Сушествуют два основных способа доступа к файлам, каждый из кото- 
рых имеет свои достоинства и недостатки. Первый заключается в примене- 
нии стандартных функций \т32 АРЕ сгеахеЕ11е, ВеаЯЕ11е, Ик1ееЕ11е, 
СоруЕ11е, Сгеафер1гесфогку, Ре1ефеЕ11е, ГосКкЕ11е, Ветоуер1гескоку, МоуеЕе, 
ЗееЕ11еРо1пеег И Оп1оскЕ11е. Дополнительно существуют также сервисные 
функции для поиска и получения информации о файлах. Второй способ 
связан с применением стандартных функций из библиотеки языка С. Он 
более простой и понятный и к тому же полностью поддерживается всеми 
операционными системами \У/тдо\5. Я опишу оба варианта, а вы сами ре- 
шайте, какой вам больше нравится. 


20.1.1. Файловые функции \Мт32 


Функция сгеакеЕ11е универсальна и позволяет создавать и открывать файлы 
любых типов, а также работать с портами или драйверами. Главным ее не- 
достатком является громоздкая и неудобная структура. Вместе с ней исполь- 
зуются функции ВеааЕ11е (чтение данных из файла) и иг1теЕ1е (запись 


686 Часть !. Общие методы программирования в ИИпаом 


данных в файл). Примеры правильных вызовов этих функций показаны в 
листинге 20.1. 


// напишем функцию для чтения данных из файла 
Боо1 ВеааСиггепеЕ11е (.сраг* Е11е, РУОТР роиЕВаЕЁег) 
{ 
// проверяем наличие буфера для данных 
1Е ( '!рообВаЕЕек) гебогп Га]15е; 
// объявляем переменные 
ОИОВР 9мЕ11е51хе = 0, дмВубезВеаа = 0; 
// открываем существующий файл для чтения 
НАМОЪЬЕ ВЕЁ1е = СгеафеЕ11е ( Е11е, СЕМЕВТС ВЕАО, 0, МОМ, 
ОРЕМ_ЕХТЗТТМб, ЕТТЕ АТТАТВОТЕ МОВМАЬ, МОТ); 
// если ошибка, выходим из функции 
1Е ( ТМУАБТО НАМОЬЕ УАТОЕ == БЕ11е) гебогп Га15е; 
// определяем размер файла | 
СмЕ11]еблхе = бееЕ11е51те ( ПЕ11е, №1); 
// устанавливаем указатель на начало файла 
ЗесЕ11еРо1пеехг ( ЬЕ11е, 0, МОШ, ЕТЬЕ ВЕС1М); 
// читаем данные из файла 
ВеаЯЕ11е ( №Е11е, рооЕВаЕЕег, ОмЕе51хе, &амВубезВеаа, МО); 
// закрываем файл 
С1озеНапа1е ( ВЕ11е); 
// выходим из функции 
тебагп ©гие; 
} 
// используем функцию ВеаЯСоггепЕЕ11е для чтения файла с диска 
сраг РоЁЁехг[24000] = ""; // буфер для считываемых данных 
// читаем файл 
ВеадА11Е11е ( "С: \\аосфоехес.Баф", БаЁЕег); 
// пишем функцию для создания нового файла 
Ьоо] СгеафемемЕ11е { сНаг* Е11е) 
{ 
// создаем новый файл 
НАМОГЕ ВЕ11]е = СгеафкеР11е ( Е11е, СЕМЕВТС ВЕАБ, 0, МОШ, 
СВЕАТЕ АПМАУЗ | СВЕАТЕ МЕМ, ЕТТЬЕ АТТАТВОТЕ МОВМАЬ, МО); 
// если ошибка, выходим из функции 
1Е ( ТМУАБТО НАМОЬЕ УАЪОЕ == ВЕф1е) гебогп Ёа15е; 
// закрываем файл 
С1озеНапа1е ( №Е11е); 
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// используем функцию СгеафемемЕ11е для создания пустых файлов 
СгеафеМемЕ11е ( "С: \\Му11 56119. 6хе"); 
СгеакемемЕ11е ( "О: \\Мурафа.Ча®"); 
// пишем функцию для записи данных в файл 
Боо1 Мг1хеСиггепЕЕ11]е ( сваг* Е11е, РУОТО рТпВоЕЁег, ОМОВО ди51херафа) 
{ 
// проверяем наличие буфера с данными 
1Е ( 'рТпВаЕЁЕег) гебогп Еа15е; 
// объявляем переменные 
ОМОКО амВусезиг1фе = 0; 
// открываем существующий файл для чтения 
НАМОТЕ ВЕ11]е = СгеатеЕ11е ( Е11е, СЕМЕВТС МВТТЕ, 0, МО, 
СВЕАТЕ МЕМ, ЕТЬЕ АТТАТВОТЕ_ МОВМАЕ, МО1,); 
// если ошибка, выходим из функции 
1 ( ЛМУАБТО НАМОЬЕ УАБОЕ == ЪЕР11е) гебогп Ёа15е; 
// устанавливаем указатель на начало файла 
ЗееЕ11еРо1пЕег ( ЬР11е, 0, МОШ., ЕТЬЕ _ВЕСТМ); 
// пишем данные в файл 
Мг1сег11е ( ВЕ11]е, рТпВоЕЕег, @51херафа, &амВусезИхг1ее, МЫ); 
// закрываем файл 
С1о5еНапа1е ( №Е11е); 
// выходим из функции 
гебсагп сгое; 
} 
// пример использования функции ИггбеСоггереЕ11е 
сваг БаЕЕег [5000] = ""; // буфер с данными 
// создаем новый файл и записываем в него данные 
Иг1сеСогкепеЕ11е ( "С:\\МуЁоа.Ехе", раЕЁЕег, э1хеоЕ ( БоЕЁЕег)); 


Примеры, рассмотренные выше, упрощены для лучшего понимания работы 
файловых функций. Например, для чтения файла сначала следует опреде- 
лить его размер, выделить достаточный буфер (или использовать цикл для 
чтения), а только потом производить считывание данных. 


Функции ТоскЕ11е И Оп1оскЕПе позволяют блокировать доступ к определен- 
ной области открытого файла, чтобы к ней нельзя было обратиться (прочи- 
тать или записать) из других процессов. Эти функции имеет смысл приме- 
нять, если нужно защитить файл от записи или чтения из других программ 
на время обработки общедоступных данных (например, записи в файл базы 
данных). Пример использования функций блокировки представлен в лис- 
тинге 20.2. 


ОМОВО 9мРоз1Е1оп = 0; // текущая позиция чтения 
ОМОВО ЧмВукезвВеаа = 0; // число прочитанных байтов 
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спаг раЕЕек [9600] = ""; // буфер для считываемых данных 

// открываем существующий файл для чтения 

НАМОГЕ ВЕ11е = СгеакеЕ1]е ( "с:\\сопЁ19.5уз", СЕМЕВТС ВЕАО, 0, МОШЬ, 
ОРЕМ ЕХТЗТТМ6, ЕТЬЕ АТТАТВОТЕ МОВМАТ, МОГ); 

// устанавливаем указатель на начало файла 

9иРо$110п = 5еЕЕ11еРо1пеег ( ВЕ1е, 0, МОЪЬ, ЕТШЕ ВЕС1М); 

// блокируем часть файла перед чтением 

Тоскг11е ( ПЕ е, ЯмРоз1е1оп, 0, @ЧмРоз1Е1оп + 9600, 0); 

// читаем данные из файла 

ВеаЯЕ1]е ( ЮЕ11е, БоЁЁЕег, 9600, &амВусезКеаа, МО); 

// разблокируем данные 

Оп1оскЕ11е ( ВЕ11е, ОмРоз, 0, ЧмРоз1Е1оп + 9600, 0); 

// закрываем файл 

С1озеНапа1е ( №Е11е); 


Функция 5еъЕ11еРо1т(ег предназначена для управления внутренним указа- 
телем позиции в открытом файле. Данная функция незаменима при произ- 
вольном доступе к файлу и позволяет определить размер файла. В листин- 
ге 20.3 представлены два примера ее использования. 
: Листинг 20.3. Работа с функцией зе Е11еРо1пфег 
// пишем функцию для определения размера файла 
РИОВР Сеф$12е ( сваг* Е11е) 
{ 

ОМОВР &мЕ11е512е = 0; // размер файла 
// открываем существующий файл для чтения 
НАМОГЕ ВЕ1]е = СгеафеЕ11е ( Ё11е, СЕМЕВТС ВЕАО, 0, МОШ, 

ОРЕМ ЕХТЗТТМС, ЕТТЬЕ АТТВАТВОТЕ МОВМАЬ, МОБ); 

// устанавливаем указатель на начало файла 
ЗекЕ11еРо1пеег ( ВЕ11е, 0, МОШТ, ЕТЬЕ ВЕСТМ); 
// устанавливаем указатель на конец файла 
ЧиЕ11е512е = бесЕ11еРо1пеег ( НЕ11е, 0, МОМ, ЕТЬЕ ЕМО); 
// закрываем файл 
С1озеНапт]е ( №Е11е); 
// возвращаем полный размер файла в байтах 
гебогп 9мЕ11е512е; 
} 
// пишем функцию для приведения к нулевому размеру указанного файла 
уо1А беЕг11е?его ( спаг* Е11е) 
{ 

// открываем существующий файл для записи 

НАМОБЕ ВЕ11е = СгеафеЕ11е ( Ё11е, СЕМЕВТС МВТТЕ, 0, МОШ,, 

ОРЕМ_ ЕХТЗТТМС, ЕТЬЕ АТТВТВОТЕ МОВМАЬ, МО); 
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// устанавливаем указатель на начало файла 
ЗееЕ11еРо1пфег ( ИРШе, 0, МОШ., ЕТЬЕ ВЕСТМ); 
// записываем признак конца файла 
ЗесЕпаоЕЕ11е ( ВЕ11е); 

// закрываем файл 

С1озеНапЯ1е ( ЪЕ11е); 


Функции СоруЕ11е, Бе1екеЕ11е И МоуеЕ11е позволяют соответственно копи- 
ровать, удалять или перемещать указанный файл. С помощью функции 
СоруЕ11е можно не только выполнять копирование с одного диска на дру- 
гой, но и переименовывать любой доступный файл. Первые два аргумента 
функции определяют имена и пути исходного и конечного файлов. Послед- 
ний аргумент устанавливает действие при обнаружении аналогичного файла 
(если он равен ЕАТЗЕ, то существующий файл будет перезаписан). Функция 
МоуеЕ11е при необходимости также выполняет переименование перемещае- 
мого файла. Кроме того, она поддерживает перемещение целых каталогов 
со всеми подкаталогами и файлами. Однако все перемещения могут быть 
осуществлены лишь в пределах одного логического диска. Чтобы перемес- 
тить файл между дисками, сначала следует скопировать его, а затем удалить 
исходную копию. 


Для создания и удаления каталогов применяются функции Сгеафер1кесьогу 
И Вепоуер1гескогу. Важно помнить, что удалить можно только пустой ката- 
лог, не имеющий вложенных каталогов и файлов. 


Примеры использования рассмотренных функций приведены в листин- 
ге 20.4. 





Листинг 20.4. Работа с файловыми функциями 





// копировать файл без переименования 

СоруЕ11е ( "С: \\\М1паом$\\М1 п. 111", "Б:\\И10.101", Еа15$е); 
// скопировать и переименовать файл 

СоруЕ11е ( "С: \\И1паомз\\И1т.111", "Б:\\И1п.109", Еа15е); 
// скопировать файл, если не существует аналога 

СоруЕ11е ( "С: \\И1раомз\\Са1с.ехе", "Б;:\\Са1с.ехе", Егие); 
// переместить файл из одного каталога в другой 

МоуеЕР11е ( "Е: \\МуМи$1с.мам", "Е: \\Маз1с\ \МУМиз1с.мау"); 
// переместить файл из одного каталога в другой с переименованием 
МоуеЕ11е ( "Е: \\МуМи$1с.мау", "Е: \\Миз1с\\Ме1оду.мау"); 

// переместить каталог без переименования 

МоуеЕ11е ( "Е: \\Тетр", "Е: \\Маз1с\\Тетр"); 

// переместить каталог с переименованием 

МоуеЕ11е ( "Е:\\Тешр", "Е: \\Ми51с\\Тетр_2"); 
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// удалить файл 

Ре1ефеЁ11е ( "С: \\ЕггогВероге.1о49"); 
// создать новый каталог 
Сгеафер1кесфкоку ( "С:\\Тетр", МОТ); 
// удалить каталог 

Вепоуе01гесфогу ( "С:\\Тепр"); 


Пример удаления каталога с файлами и подкаталогами рассмотрен в лис- 
тинге 20.5. 





// пишем функцию удаления каталога 
уо1а Ое1Ео14ег ( спаг* рафп) 
{ 


НАМОТЕ ВЕЗта = МО; // дескриптор поиска подкаталогов и файлов 
№132 ЕТМО РАТА ЕЁ; // структура поиска 
сВаг раЕЕег[МАХ_РАТН] = ""; // временный буфер 
сВаг* рМаце = МОШ.; // указатель на имя файла 
// обнуляем структуру 
2егоМепоку ( &ЕЁ, э1хеоЕ ( М1М32 ЕТМО ПАТА)); 
// создаем маску для поиска файлов 
5ре1п ЕЕ ( БаЕЕег, "%5\\*,*", раЕВ); 
// ищем первый файловый объект 
БЕ1лпа = Е109Е1и56Е11е ( БаЕЁег, &ЕЕ); 
// если ошибка, выходим из функции 
1Е ( БЕфла == ТМУАЬТО НАМОГЕ УАЬОЕ) 
тесагп ЁЕа15е; 
// создаем цикл 
ао 
{ 
// получаем указатель на имя найденного файлового объекта 
рМапе = ЕЁ. сЕ11еМапе; 
// пропускаем лишнее 





1Е ( рМаме[1] == 0 && *рМаме == '.') 
сопЕ1пае; . 

е1зе 1Ё ( рМаме[2] == 0 && *рМаме == '.' && рМаме[1] == '.') 
сопЕ1тие; 


// записываем имя найденного объекта и организуем путь 
зрелое Е ( РаЕЕег, "%$\\$5", рабь, ЕЁ.сЕ11еМаме); 
// если объект защищен от записи, снимаем атрибут 
1Е ( ЕЁ. ОмЕ11еАсст1рибез & ЕТЬЕ АТТВАТВОТЕ ВЕАРОМГУ) 
ЗеЕЕ11еАЕекг1рабез ( роаЕЕег, 
ЕЕ. м1 1еАсегарисе$ & -ЕН.Е АТТАТВОТЕ ВЕАРОМПУ); 
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// если найденный объект является каталогом 
1Е ( ЕЕ. ОмР11еАбсегарисез$ & ЕТЬЕ АТТВТВОТЕ ОТВЕСТОВУ) 


{ 
// рекурсия 
Ре1Ео1аег ( ЮщЕЕег); 
} 
е1зе 
{ 
// удаляем файл 
Ре1ефеЕ11е ( БиаЕЕег); 


} 

// ищем следующий файл 

\р11е ( ЕлоЧМехеЕ11е ( Ета, &#Е)); 

// закрываем дескриптор поиска 

Е1па9С1о5е ( №ВЕ1па); 

// удаляем корневую папку 

1Е ( ЕЕ. ЧмЕТ1еАбсгуросез & ЕТТЕ АТТВТВОТЕ ВЕАРОМГУ) 
// если необходимо, снимаем атрибут 
ЗесЕ11еАееу1росез ( рай, 

ЕЕ. ЗмЕР11еАеег1росез & -ЕТЬЕ АТТАТВОТЕ ВЕАБОМЬУ); 
// удаляем корневую папку 
Вешоуе01тесеогу ( раёй); 


Приведенный выше код будет без проблем работать в \шдо\з 9х/МЕ, од- 
нако в профессиональных системах необходимо дополнительно получить 
права доступа для удаления каталога с диска. Пример кода, демонстрирую- 
щий регистрацию прав на удаление каталога, представлен в листинге 20.6. 


// пишем функцию инициализации для установки прав доступа к объекту 
Боо]1 Тп1Ассез$ ( сБаг* ор)ес®) 
{ 
// дескриптор доступа для текущего процесса 
НАМОГЕ РНап91еТоКкеп = МОШ; 
10е Е11е _О0Б)есф[255]; 
РИОВО Вапа1е = 0; 
// идентификация пользователя объекта 
ТОКЕМ _ОЗЕВ *изег = ( ТОКЕМ 95ЕВ*) Е11е ОБ)есе; 
// дескриптор безопасности 
ЗЕСОВТТУ РЕЗСВТРТОВ зес_Ппапа1е; 
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// информационная структура дескриптора безопасности 
ЗЕСОВТТУ ТМЕОВМАТТОМ 1по_цзег = ОИМЕВ_ЗЕСОВТТУ _ТМЕОВМАТТОМ; 
// инициализируем новый дескриптор безопасности 
10161а11хебесиг16убезск1реог ( &зес Папоа1е, 
ЗЕСОВТТУ РЕЗСАТРТОВ ВЕУТЗТОМ); 

// открываем дескриптор доступа для текущего процесса 
1Е ( ОрепРгосеззТокеп ( бееСаггепЕРгосез5 (), ТОКЕМ ВЕРА | 

ТОКЕМ АБЗОЗТ РАТУТЬЕСЕЯ, & ВНара1еТокеп) ) 


// устанавливаем уровень доступа 
1Е ( Зе%Рг1у11еде ( ЬНапд]1еТокеп, ЗЕ ТАКЕ ОИМЕКЗНТР МАМЕ, Еа1зе)) 
{ 
// получаем необходимую информацию о дескрипторе доступа 
1Е ( СеетокепТлЕохлаЕ1оп ( ПНапа]еТокеп, ТокепОзег, изек, 
з1хеоЕ ( Е11е Ор)десе), &рапо1е))} 
{ 
// заменяем дескриптор безопасности 
1Е ( Зеё$есиг1$убезст1реогОмпег ( &5ес папоа]1е, 
изег->05ег.5$14, ЁЕа15$е)) 


// устанавливаем защиту для файлового объекта 
1Е ( ЗесЕ11ебесог1еу ( об)есе, 1пФо цзег, &зес Бапа1е) } 
гесагп гие; // если нет ошибок 


} 
// отключаем права доступа 
Тоа9Рг1\11еде ( ПНапа1еТокеп, ЗЕ ТАКЕ ОММЕВЗНТР МАМЕ, ©гае); 
// выходим из функции с ошибкой 
гебогп Еа15е; 
} 
// пишем функцию доступа к файловому объекту 
Боо] ЗефАссез$Е11е ( сопзЕ спаг* ор]есе, сопзЕ сБаг* р52Ассезз, 
РИОВО @мМазк) 


// определяем переменные 

ЗЕСОВТТУ РЕЗСВТРТОВ зес Вапа]1е; 

ЗЕСОВТТУ ТМЕОБМАТТОМ 1по_зес = РАСТ, ЗЕСОВТТУ ТМЕОВМАТТОМ; 
10е тр [512]; 

СБаг Чота1п папе [512]; 

$Тр МАМЕ ОЗЕ 514 паме; 

РТО 514 = ( Р$ЗТО*) пр; 
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АСЬ *11$5%; 
О\ОВО аота1п_512е = 01, $14 $12е= 01, 1156 э14те = 01; 
// инициализируем новый дескриптор безопасности 
Тп161а112ебесиг1$уезсг1реог ( &зес Бапа]1е, 
ЗЕСОВТТУ РЕЗСВТРТОВ_ ВЕУТЗТОМ); 
// получаем идентификатор безопасности $10 
1Е ( ТоокорАссоопеМаме ( МО, рз2Ассез$, $149, &31@ 512е, Яаота1п паме, 
&Аота1п_512е, &51а паме) )} 


// инициализируем список доступа 
1152 512е = э1хеоЕ ( АСП) + э12еоЕЁ ( АССЕЗ$ АБЬОМЕР АСЕ) + 
сееъепаев51а ( Епр) - э1хеоЕ ( ОМОВО); 
// выделяем память из кучи 
115% = ( АСГ *) НеарА11ос ( бефРгосеззНеар (), НЕАР 2ЕВО МЕМОВУ, 
1156 312е); 
// создаем новый список доступа 
1Т1161а112еАс1 ( 1152, 1156 $12е, АСЬ ВЕУТЗТОМ); 
// открываем доступ для указанного идентификатора безопасности 
1Е ( АЧЯАссеззА11очедАсе ( 113%, АСЬ ВЕУТЗТОМ, амМазк, э1а))} 
{ 
// добавляем в список доступа необходимую информацию 
1Ё ( Зесбесиг1урезск1реогВас1 ( &5ес ВапЯ1е, сгае, 1.15%, 
Га1зе)) 


// устанавливаем защиту для файлового объекта 
1Е ( зегПебесог1еу ( ордесё, 1пЕо_5ес, &зес папа1е)) 
герогп (гие; // если нет ошибок 


} 

// освобождаем память 

1Е ( 1156 != МОЪЬ) 

НеарЕтее ( СефРгосез$Неар (), 0, ( ЪРУОТО) 115%); 
// выходим из функции с ошибкой 
гебогп ЁЕа1зе; 
} 
// пишем функцию для установки уровня привилегий 
у014 .оа9Рг1у11еде ( НАМОЪЕ БНапЯ1еТокеп, соп$е сБаг* рз2раба, 
Боо1 Б5еф) 


ЦО 1оТ0; // уникальный идентификатор 
ТОКЕМ РАТУТЬЕСЕЗ фокеп_рг1\у; // информация о доступе 
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// если требуется определить параметры доступа 
1Е ( '55$еЕ &5 рзхбаба != МОШ,) 
{ 
// получаем идентификатор 
1Е ( ГоокарРг1У11едеУа1ае ( МО, р52Баба, &1атр)) 
{ 
// определяем параметры доступа 
фокеп_рг1у.Рг1\11еде5[0].Га14А = 1210; 
фокеп_рг1У.Рт1\11едеСоипе = 1; 
фокеп_рг1У.Рт1\11едез[0].Абег1акез = 5Е _РВТУТЬЕСЕ ЕМАВЬЕО; 
} 
} 
// разрешаем или запрещаем привилегии 
А) азТокепРг1711едез ( ЬНапа1еТокеп, бек, & сокеп рг1\, 
$12е0Е ( ТОКЕМ РАТУТЬЕСЕ$), ( РТОКЕМ РВТУГЦЕСЕ$) МОБ, 
( РОМОВО) МЧ); 
} 
// добавляем функции установки прав доступа в основной код 
// 
// если найденный объект является каталогом 
1Е ( ЕЕ. ЧмЕ11еАкетарофез & ЕТЬЕ АТТВТВОТЕ ОТВЕСТОВУ) 
{ 
// установка доступа 
1Е ( ТОКАссезз ( роЕЕег) } 
{ 
// получаем доступ к файловому объекту 
ЗекАссез$Р11е ( РаЕЁег, "зеб епаб?е ассез5", СЕМЕВТС АП); 
} 
// рекурсия 
РефКо14ег ( РаЕЁЕег); 
} 
е1зе 
{ 
// установка доступа 
1Е ( Тп15Ассезз ( роЕЕег) } 
{ 
// получаем доступ к файловому объекту 
ЗекАссез$Е11е ( раЕЁег, "зеф_ епаБ1е ассезз", СЕМЕВТС_АШ)); 
} 
// удаляем файл 
БезефеЕ11е ( БаЕЁЕег); 
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Кроме основных файловых функций, имеется набор дополнительных функ- 
ций, используемых преимущественно для получения и установки различных 
параметров файловой системы. К ним относятся функции поиска 
(ЕзпаЕ1гзЕЕ11е, Е1паМехеЕ11е, Е1паСс1озе), получения и установки атрибу- 
тов файла (зееЕз1еАеег1Ьаеез И СееЕ11еАкег1ЪЬофез), сброса кэша на диск 
(Е1азрЕ11еВоЕЕегз), получения и установки  текушего каталога 
{сексиггепЕр: гесвогу И ЗеЕСаггепе01 кескогу), определения свободного места 
на диске (сеёр1зкЕгееЗрасеЕх), получения типа диска (секркгзуеТуре) и опре- 
деления размера файла (сееЕ11е512е И СееЕ11е$1теЕх). 


С функциями поиска мы уже познакомились ранее. Добавлю только, что 
они позволяют найти любые типы файлов или каталогов на указанном ло- 
гическом диске. Как правило, для поиска вложенных файлов применяется 
метод рекурсии (вызов функции самой себя), что может привести, в частно- 
сти, к переполнению стека. Чтобы исключить такую проблему, рекомендую 
устанавливать ограничительный счетчик на количество рекурсивных вызо- 
вов функции, а также создавать саму функцию поиска как статическую. 
В листинге 20.7 показан пример кода, выполняющий поиск всех файлов 
с расширением (5 на диске С:. 


Листинг 20.7. Использование функций поиска файлов 


// напишем функцию поиска текстовых файлов и добавления их в список 
уо1а Е1па_Р11е ТХТ ( НИМО В115ЕВох, сВаг* ра®В) 
{ 
// определяем необходимые переменные 
НАМОБЕ БВЕзпа = мо; 
ИТМ32 ЕТМО РАТА ЕЕ; 
ТСНАВ БоЕ[МАХ_РАТН] = ""; 
// обнуляем структуру поиска файловых объектов 
2егомемогу ( &ЁЕЁ, з12ео0оЕ ( И1М32_ЕТМО РАТА)); 
// определяем указатель на путь 
сраг *рег = раб; 
УП11е ( *рег) рёг++; 
// добавляем маску поиска 
зЕгсру ( рег, "\\*.*"); 
// начинаем поиск первого объекта 
БЕТ = Езпа9Е1у$Е11е ( раб, &ЕЕ); 
// если ошибка, выходим из функции 
1Е ( ВЕЗоа != ТАУАЬТО НАМОЬЕ УАБОЕ) 
{ 
// проверяем все злементы 
ао 
{ 
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// отсекаем лишнее 
1Е ( ЕЁ. сЕ11еМаще[0] != '.' || 
( ЕЕ.сЕ11еМаме{1] != '.' && ЕЁ. СсЕ11емате[1])) 


// сохраняем указатель на путь для обработки вложенных папок 
зЕгсру ( рег + 1, ЕЁ. сЕ11еМапте); / 
// если найденный объект является папкой 
1Е ( ЕЁ. амЕ11еАбст1рофсез 5 ЕТЬЕ АТТАТВОТЕ ОТВЕСТОВУ) 
{ 
// вызываем свою функцию повторно и контролируем ошибки 
фгу 
{ 
Е1па_Е11е ТХТ ( №11$%ЕВох, рав); // рекурсия 
} 
саксв (...) 
( 
// переходим к следующей итерации цикла 
сопЕ1пае; 


} 
е1зе // если найден файл 
{ 
// копируем найденный файл в буфер 
зЕгсру ( РоЁ, ЕЁ. СЕ11еМаме); 
// переводим в нижний регистр 
зЕх1мг ( БаЕЁ); 
// ищем расширение в имени файла 
срах* ехЕ = зЕггсрк ( РаЕЁ, '.'); 
// если расширения нет или оно не равно "хе", ищем дальше 
1Е ( ехЕ != МОБ && зегтсюр (ехЕ, ".6хё") == 0} 
{ 
// добавляем имя файла в стандартный список 
Зеп9Меззаде ( №115&Вох, ГВ АОРЗТВТМС, 0, 
( ГРАВАМ) ( ТРСТЗТВ) БаЕ); 


} 

} 
// ищем следующий файловый объект 
} мБ1]е ( ЕзпаМехеЕ11е ( БРапа, &ЕЕ)); 
// закрываем дескриптор поиска 
Е1паС1озе ( ВЕ1та); 
БЕ1ра = МО; 
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// пример вызова функции Ета Е41е ТХТ 

// получаем дескриптор окна для списка 

НИМО р115%&Вох = Сбеео19Теет ( №019, ТОС МУШТЗТВОХ); 
сваг рабр[МАХ_РАТН] = ""; 

// указываем букву диска для поиска текстовых файлов 
$Егсру ( раб, "С:"); 

// вызываем функцию поиска 

Езпа_Е11е ТХТ ( №115%Вох, раеь); 


Если вам требуется найти файл (файлы) для операции доступа (чтение, 
запись) или удаления, сначала следует снять атрибут еТЬЕ АТТАТВОТЕ ВЕАРОМЬУ 
(только для чтения) и только потом выполнять какие-либо действия. 


Для установки или получения текущих атрибутов файла применяются две 
функции зеее:1еАеекзрисез И СееЕ11еАеек1рофез. Объекты файловой систе- 
мы в \/тд0\5$ могут иметь следующие атрибуты: 


С ЕЕ АТТАТВОТЕ АВСНТУЕ — архивный файл или папка, доступный для уда- 
ления; 


ЕТШЕ АТТВТВОТЕ МОВМАЬ — атрибуты отсутствуют; 
ЕТЬЕ АТТВТВОТЕ нНТОРЕМ — скрытый файл или папка; 
ЕГШЕ АТТВТВОТЕ ВЕАРОМЬУ — файл или папка доступны только для чтения; 


ЕТЬЕ АТТВАТВОТЕ ЗУЗТЕМ — системный файл или папка; 


оооосо 


ЕГЬЕ АТТВТВОТЕ_ОТВЕСТОВУ — файловый объект является каталогом. 


Существуют еще несколько атрибутов, но они используются крайне редко. 
Значение ЕЕ АТТВАТВОТЕ_МОВМАГ отменяется комбинацией любых других ат- 
рибутов. В листинге 20.8 приводятся примеры установки и получения атри- 
бутов для файловых объектов. 


Листинг 20.8. Установка и получение атрибутов 





// проверяем различные атрибуты для заданного файла 
РМОВО ЧмАЕЕг1Ь = СесЕг11еАкетзРосез ( Е11еМате); 
// если только для чтения 
1Е ( ЧМАБЕЕЬЬ & РГЦЕ АТТАТВОТЕ ВЕАРОМГУ) 
{ 
// сбрасываем атрибут 
ЗееЕ11еАкег1риеез ( Е11еМаше, ЧмАбет1Ь ^ ЕТТЕ АТТАТВОТЕ ВЕАБОМЦУ); 
} 
// если не системный 
1Е ( ЧмАЕЕг1 & ЕГЫЕ АТТАТВОТЕ 5У$ТЕМ) != РТЬЕ АТТАТВОТЕ ЗУЗТЕМ) 
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// устанавливаем атрибут 
ЗеёЕ11еАкег1расез ( Е11еМаше, ОмАЕег1Ъь | ЕТЬЕ АТТАТВОТЕ ЗУЗТЕМ); 
} 
// проверяем наличие папки 
1Е ( ЧмМАСЕЕЬ & ЕТЬЕ АТТВТВОТЕ ОТВЕСТОВУ) == ЕТЬЕ АТТВТВОТЕ ОТВЕСТОВУ) 
{ 


// выполняем какие-либо действия 


Функция Е1озвЕ11еВиЕЕегз дает возможность немедленно записать все буфе- 
ризированные данные для открытого файла на диск. Поскольку операцион- 
ная система хранит данные в промежуточном буфере (для ускорения рабо- 
ты) и записывает их на диск в удобное для себя время (например, во время 
простоя), пользователь рискует потерять важные данные при внезапном от- 
ключении питания или другом аппаратно-программном сбое. Вызов функ- 
ЦИИ Е1азВЕ11еВиЕЕегз После записи всех данных в файл гарантирует их со- 
хранение на диск. Данная функция имеет всего один аргумент (дескриптор 
открытого файла) и проста в использовании. 


Для получения и установки текущего каталога (в текущем процессе) приме- 
няются соответственно функции сееСаггепЕО1гесвоку И Зе СаггепЕО1гесфоху. 
Их удобно вызывать перед работой с файлами, расположенными в текущей 
папке приложения. Первая функция имеет два аргумента: размер и указа- 
тель на выделенный буфер. Вторая просто определяет строковое значение 
для установки текущего каталога. Примеры получения и установки текуще- 
го каталога показаны в листинге 20.9. 





// получаем текущий путь для нашей программы 

ТСНАВ $2Сиггеп® Рак [МАХ_РАТН]; 

1Е ( СесСоггепеО1кесвокгу ( з12еоЕЁ ( з2РаЪфН} / з12еоЕ ( ТСНАВ), 
$2РаЕП) ) 


// выводим сообщение 

МеззадеВох ( МОШЬ, з2Ра®Н, "Текущий путь", МВ_ОК); 
} 
// устанавливаем новый путь для нашей программы 
сваг рафь [МАХ_РАТН]; 
1Е ( СеесогхепЕО1тесеохгу ( з1теоЕ ( ра®бБ), рабп)}) 
{ 

// новый путь 
ЗеЕСоггепЕО1гесвокгу ( ра®В); 
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// открываем файл данных из текущей папки программы 
1Е ( бееСиггепЕр1кесеокгу ( з12еоЕ ( рабВ), ра®Ъ)) 
{ 
// добавляем имя открываемого файла 
зЕгсае ( рабр, "\\Веадту.6хе"); 
// открываем и обрабатываем файл 
НАМОЪЕ ВЕ11е = СгеафеЕ11е ( рабй, СЕМЕВТС_ВЕАО, 0, МЩШ, 
ОРЕМ_ЕХТЗТТМС, ЕП.Е АТТАТВОТЕ МОВМАТ,, МО); 
// если ошибок нет 
1Е ( ТМУАБТО НАМОЬЕ УАБОЕ != ВЕТе) 
{ 
// выполняем какие-либо операции над файлом 
// 
// закрываем файл 
С1озеНапа1е ( ВЕ11е); 


Следующая функция, которую мы рассмотрим, связана с определением сво- 
бодного места на логическом диске и называется сеер1зкЕгеезрасеЕх. Суше- 
ствует более старая версия данной функции, поддерживающая диски разме- 
ром не более 2 Гбайт, но она практически не применяется. Функция сек- 
21зкЕгеебрасеЕх имеет четыре аргумента. Первый аргумент задает имя диска. 
Если установить его в мо, будет возвращена информация для текущего 
диска. Второй аргумент представляет собой указатель на переменную, 
содержашую общее число свободного места на диске в байтах для вызы- 
вающего потока (доступного пользователю). Третий указывает на общий 
размер диска. Последний аргумент возвращает общее число свободного 
места на диске в байтах. Пример работы с данной функцией представлен 
в листинге 20.10. 


уо1а Звомо1т$Кк512е () 
{ 
// напишем функцию, определяющую размер диска 
СВаг* 41зк = "р:\\"; // задаем букву диска 
сваг раЕ[ 100]; // буфер для форматирования данных 
// переменные для хранения результата 
01$1апе4 __ 1164 и164ЕгееВуфезОзег, 164Тотса1Вусез, 
0164Тофа1ЕгееВукез; 
// вызываем функцию 
1Е ( Сефр1КЕгеебрасеЕх ( 41зКк, ( РОБАВСЕ ТМТЕСЕВ) &1164ЕгееВусез0зех, 
( РОБАБСЕ ТМТЕСЕК) &164Тофа1Вусез, 
( РОГАБСЕ ТМТЕСЕВ) &0164Тофа1ЕгееВукез)) 
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// форматируем полученный результат 
зрерпЕЁ ( БаЁ, "Тоба1: %164а МВ\п Егее: %164а МВ\п \ 
Егее Озет: %164а МВ", и164Тофа1Вусез / ( 1024 * 1024), 
1164Тоса1ЕтееВуеез / ( 1024 * 1024), 
0} 64ЕтееВусез0зех / ( 1024 * 1024)); 
// выводим на экран сообщение 
МеззадеВох ( МО, БаЁ, "Вероге", МВ_ОК); 
} 


Функция Сееог1уеТуре позволяет определить тип подключенного дисково- 
да. Поддерживаются следующие типы дисков: жесткий, гибкий, сетевой, 
СО-КОМ, виртуальный (созданный в памяти). Функция принимает один 
аргумент, определяющий букву логического диска. Демонстрационный при- 
мер работы с этой функцией показан в листинге 20.11. 


Листинг 20.11. Определение типа диска 








// напишем функцию, позволяющую определить все типы дисков, установленных 
//, на компьютере, и записать эту информацию в раскрывающийся список 
роо1 Гоаарг1уез ( НУМО ЮСопьоВох) 


{ 
ОМОВО ЧмОт1чуе = 0; 
01$19пеЯ 1пе погауеТуре = 0; 
10Е пПРоз = 0; 
сраг ЪБаЕЁ[20] = ""; 
116 сВ = 0; 
// получаем все логические диски, имеющиеся в системе 
фгу 
{. 
Чиргфуе = Сее1од1са1Ох1Уез (}; 
// перечисляем найденные диски 
у 11е ( 9м0х1 уе} 
{ 
// получаем букву диска и добавляем атрибуты 
1Е ( Чмоуаме & 1) 
{ 
ср = 0х41 + пРоз; 
13 ксру ( БаЁ, ( ЬРСТЗТВ)} &сВ); 
15ехсае ( БаЁ, ":\\"); 
// определяем тип диска 
пох1уеТуре = Сбесру1уеТуре ( БаЕ); 
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13 тсруп ( РаЕЁ, РоЕ, 3); 
эзм1Еср ( пог1уеТуре} 

{ 

сазе ОВТУЕ ВЕМОУАВГЕ: 


ЁфзЕгсае ( РоЕЁ, " ( гибкий диск)"); 
Ъгеак; 

сазе ОВТУЕ ЕТХЕО; 
1$зе:сае ( БаЁ, " ( жесткий диск)"); 
Ъгеак; 

сазе ОВТУЕ СОВОМ: | 
фзегсае ( роЕ, " ( СО-ВОМ)"); 
Ъгеак; 

сазе ОВТУЕ_ ВЕМОТЕ: 
Ё56гсае ( БоЕ, " ( сетевой диск}"); 
Ъгеак; 

сазе ОВТУЕ_ ВАМОТЗК: 
]1з&гсае ( БоЁ, " ( виртуальный диск)"); 
Ьгеак; 


} 

// добавляем диск в список 

ЗепаМеззаде ( ПСошбоВох, СВ _АООЗТАТМС, 0, ( БРАВАМ) раЕ); 
// переходим к следующему диску 

Чмоттуе >>= 1; 

пРо$++; 


} 
сафсв (.. .) 
{ 


гефогп Еа1зе; // ошибка 


} 


гебагп сгие; // успешное выполнение 


Функции сееЕ11е5$12е И СезЕ11е312еЕх позволяют определить размер файла в 
байтах, открытого с использованием одного из флагов: секЕМЕВТС ИВТТЕ ИЛИ 
СЕМЕВТС ВЕАР. Первая функция имеет два аргумента — дескриптор открытого 
файла и указатель на старшее 16-разрядное значение размера. Второй аргу- 
мент применяется для измерения больших файлов, иначе он должен быть 
установлен в мот. При работе с большими файлами можно вызывать функ- 
ЦИЮ СеЕЕ11е512еЕх (только для \Мш4ом$ МТ/2000/ХР/$ КЗ). Она также имеет 
два аргумента, но поддерживает очень болыпие файлы. 


В УС+- версии 6.0 определение функции сееЕ11е512еЕх может отсутство- 
вать, что приведет к ошибке компиляции. Данную проблему можно решить 
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одним из трех способов: вызвать функцию динамически, обновить файл 
У/пьазе.В или использовать оболочку УС++ .МЕТ. 


Кроме перечисленных выше, существует еще одна интересная и полезная 
функция для определения реальных размеров сжатого файла, которая назы- 
вается сееСошртеззеаЕ11е512е. Ёе первый аргумент указывает на имя файла, 
а второй — на переменную, в которую будет помещено старшее 16-разряд- 
ное значение результата. К сожалению, эта функция предназначена только 
для профессиональных операционных систем (УИпдо\м$ МТ/2000/ХР/5ВЗ). 
Примеры работы с рассмотренными функциями показаны в листинге 20.12. 


Листинг 20.12. Определение размера файла 


// использование функции Секг11е512е 


// получаем размер стандартного файла 


ОИОВО Сеф$1те 


{ 


{ сопзЕ сваг* Е11е) 


ОМОВО амЕ11еб1те = 0; 
// открываем существующий файл для чтения 
НАМОЬЕ ВЕ1]е = СгеафеЁ11е ( Ее, СЕМЕВТС ВЕАР, 0, шь, 


ОРЕМ ЕХТЗТТМС, ЕПЬЕ АТТВТВОТЕ МОВМАТЬ, МОШ.); 


// если ошибка, выходим из функции 
1Е ( ТМУАПТЬ НАМОГЕ УАГОЕ ==. ВР11е) гебогп 01; 
// определяем размер файла 


ЧмЕР1]е512хе 


= Се*Е11е512е ( ВЕ11е, МОШ); 


// закрываем дескриптор файла 


С1озеНапа1е 


( ВЕе); 


// возвращаем результат 


гебагп ЧмР11е517е; 


} 


// получаем размер большого файла 
ОИОВО Сееагдеб1те ( сопз® спаг* Е11е) 


{ 


РИОВО ЧмТоб12е = 0, 9мН1$1те = 0; 
// открываем существующий файл для чтения 
НАМОЬЕ ЮЕ1]е = Сгеа®еЁР11е ( Еле, СЕМЕВТС ВЕАО, 0, МОШ, 


ОРЕМ ЕХТЬТТМС, ЕТЬЕ АТТВАТВОТЕ МОВМАТ, МЫ); 


// если ошибка, выходим из функции 
1Е ( ТМУАБТО НАМОЬЕ УАЦОЕ == БЕЁ1е) гебаго 01; 
// определяем размер файла 


ОмЬо$12е 


СефЕ11е$17е ( ПЕ1]е, &@мН1$17е); 


// закрываем дескриптор файла 


С1озеНапа1е 


( ВЕ1е); 
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// проверяем ошибки 
1Е ( ( № ЕВВОВ != СебьазЕЁЕггог ()) && ( ЧмТоЗ12е == -1)) 
хебагп 01; // ошибка 
// возвращаем результат 
гефагп ( МАКЕГОМС ( амЪоб12е, 4мН1$5127е)); 
} 
// использование функции СефЕ11е$1теЕх 
// получаем размер любого поддерживаемого в И1паомз файла 
ипз1апеа __ 11664 СефАпуЕ11е51те ( сопзЕ сваг* Е11е} 
{ 
91$191пеа __ 11664 а164Тофа1512е = 0; 
// открываем существующий файл для чтения 
НАМОШЕ ВЕЁ]е = СгеафкеЕ11е ( Е11е, СЕМЕВТС ВЕАО, 0, МО, 
ОРЕМ ЕХТЗТТМС, ЕТГЬЕ АТТАТВОТЕ МОВМАГ, М); 
// если ошибка, выходим из функции 
1Е ( ТМУАБТО НАМОБЕ УАБОЕ == ВЕ11е) гебагп 01; 
// определяем размер файла 
рооф ЮВези1Е = СекЕ11е$12хеЕх ( ВЕ11е, &0164Тоба1$17е); 
// закрываем дескриптор файла 
С1озеНапа1е ( ВЕ1]е); 
// проверяем ошибки 
1Е ( 'ЮВеза) гебаго 0Ъ; // ошибка 
// возвращаем результат 
гебагп и164Тока1$517е; 
} 
// использование функции СеЕСопргеззеЯЕ11е$ 12е 
// получаем реальный размер сжатого файла 
ОМОВО Сеф512еАгср1уеЕг11е ( сопзф сВаг* Ё11е) 
{ 
ОМОВО 9мЕ11е51те = 0; 
// получаем размер файла 
9мЕ11е512е = сееСсопргеззеаЕ11е$12е ( Е11]е, М№Ш,); 
// проверяем ошибки 
1Е ( амЕ11е512е == -1) гебагп 01; 
// возвращаем результат 
гебоагп ФмЕ11е512е; 


Кроме стандартных средств \/ш32 АРТ, для поддержки файловых операций 
в реальных программах применяются потоковые функции языка С, пол- 
ностью совместимые с интерфейсом У\У/т32 АРИ. 
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20.1.2. Файловые функции языка С 


Наиболее часто используются следующие функции: Еорер (открытие файла), 
_Езореп (открытие общего файла), Ес1озе (закрытие файла), ггеаа (чтение 
данных), Емгаке (запись данных), Езеек (управление указателем позиции в 
файле), ЕЕТазь (сброс всех буферов на диск), Едекс (чтение одного символа 
из потока), Ераес (запись символа в поток), Едеез (чтение строки символов 
из потока), Ераез (запись строки символов в поток), ЕргеареЕ (запись отфор- 
матированных данных в поток), ЕзсарЕ (чтение отформатированных данных 
из потока), Ефе11 (получение текущей позиции в файле). Кроме перечис- 
ленных, имеются и другие функции, о которых можно прочитать в любой 
книге по программированию в С/С++. 


Для открытия или создания нового файла применяется функция Еореп. Она 
имеет два аргумента: имя файла и режим доступа, а в случае успеха возвра- 
щает указатель на открытый файл (ЕтьЕ*). Примеры работы с ней показаны 
в листинге 20.13. 


Листинг 20.13. Использование функции Еореп 





Ч1осТаае <5ЕЧ1юо.Н> 

// дескриптор файла 

ЕТЬЕ* Е11е = МО; 

// открываем как двоичный файл для чтения 

1Е { (Ее = Еореп ( "с: \\аабоехес.рае", "тф")) == МОБ) 
{ 


// ошибка, не удалось открыть указанный файл 


// открываем как двоичный файл для записи в конец 
1Е ( ( Е11е = Еореп ( "с: \Лачвоехес.рае", "аб")) == МОШ,) 


// ошибка, не удалось открыть указанный файл 


// создаем как двоичный файл для записи 
1Е ( ( Е11е = Еореп ( "с:\\Муьоа.1о4", "мр")) == МОШ)) 


// ошибка, не удалось создать указанный файл 


// открываем как двоичный файл для чтения и записи 
1Е ( ( Е11е = Еореп ( "с:\\МуРгод.1тф ", "хЬ+")) == МОБ) 


// ошибка, не удалось открыть указанный файл 
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// создаем двоичный файл для чтения и записи 
1Е ( ( Е11е = Еореп ( "с:\\МуРгод.111 ", "мр+")) == МОШ)) 
{ 
// ошибка, не удалось создать указанный файл 
} 
// открываем как текстовый файл для чтения 
1Е ( (Е11е = Еореп ( "с:\\ачбоехес.Бае", "г")) == №0) 
{ 
// ошибка, не удалось открыть указанный файл 
} 
// создаем текстовый файл для записи 
1Е ( (211е = Еореп ( "с:\\Мутод.1о9", "м")) == МОМ) 
{ 
// ошибка, не удалось создать указанный файл 


Функция _Езореп аналогична предыдущей, за исключением одной важной 
особенности — она позволяет обращаться к файлам, уже используемым 
другими программами. Как правило, данная функция позволяет решить 
некоторые специфические задачи. В листинге 20.14 показан пример работы 
с функцией _Езореп. 


| Листинг 20.14. Использование функции _Езореп 


Нис1Таае <зВаге.В> 
ЕТЬЕ* Ее = МОБЬ; // дескриптор файла 
сваг БаЁ[ 101]; // буфер для данных 
// открываем наш выполняемый файл программы (сами себя) 
// для чтения и записи 
1Е ( (Ее = _Езореп ( Ехемаше, "г", _$Н РЕМУМО)) == МО) 
{ 
// ошибка, не удалось открыть указанный файл 
} 
// установим указатель на начало блока каких-либо данных, 
// расположенных в конце нашего выполняемого модуля 
Езеек ( #11е, -100, ЗЕЕК_ЕМО); 
// читаем данные в буфер 
Етеаа ( &раЕЁ, 1, э1теоЕ ( БоЁ), Е11е); 
// закрываем файл 
Ес1о5е ( #11е); 
// обрабатываем полученные данные 


и 
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В нашем примере мы открыли собственный выполняемый модуль (файл 
с расширением ехе) и прочитали ранее сохраненные в нем данные. Такую 
методику работы с файлами можно применять для различных трюков, из- 
влекая необходимую информацию из "самого себя". При компиляции про- 
граммы не забудьте добавить файл определений зпаге.НВ в начало кода. 


Функции ЕхеаЯ И ЁЕиг1%е предназначены соответственно для чтения и записи 
данных в открытый файл. Обе они имеют по четыре аргумента: указатель на 
буфер данных, размер блока данных, число блоков и указатель на дескрип- 
тор открытого файла. Как ими пользоваться, показано в листинге 20.15. 





Листинг 20.15. Операции чтения и записи в файл 


#1пс1аде <591юо.Н> 
// пишем функцию для чтения из одного двоичного файла в другой 
уо1А ВеааЕ11ерафа ( ЕТЬЕ* экс, ЕТЬЕ* Чезе, сВаг* рВиЕЁЕег, РИОКР Чи512е) 
{ 
РИОВР ЗмСиггепЕВеаЯ = 0, амВеааВуеез = 0; 
// запускаем цикл обработки 
\мр11е ( амСаггепЕВеаа < 9мЗ12е) 
{ 
// читаем блок данных из исходного файла 
@ЧмВеаЯВуЕез = Егеаа ( рВиЕЕег, 1, 2048, $гс); 
// записываем прочитанные данные в конечный файл 
Еиг1е ( рВиЕЕег, ОмВеадВукез, 1, аез®); 
// увеличиваем счетчик прочитанных байтов 
ЧиСиггепеКеаа += амВеаЯВуез; 


} 
// пишем функцию для определения размера открытого файла 
1оп9 беё512еАпуЕ11е ( ЕТШЕ* Е11е) 
( 
1опа сиггепе = 0, 1еп = 0; 
// сохраняем текущую позицию в файле 
сиггепЕ = ЁЕ%&е11 ( Е11е); 
// переводим указатель в конец файла 
Езеек ( ЁЕ11е, 01, ЗЕЕК ЕМО); 
// получаем текущую позицию в файле 
1еп = Е&е11 ( Ее); 
// возвращаем указатель на прежнюю позицию 
Езеек ( Е11е, саггере, ЗЕЕК_5ЕТ); 
// возвращаем полный размер файла в байтах 
гебагп 1еп; 
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// пишем собственно функцию копирования файла 
Боо1 СоруАпуЕ11е ( сопзЕ спаг* згс Ё11е, сопзЕ спахг* Чез® Е11е) 
{ 

// указатель на буфер данных 

сраг* рВиЕЕег = МОШ; 

// размер исходного файла 

РИОВР 9мЕ1]еб12е = 0; 

// дескрипторы исходного и конечного файлов 

ЕТЬЕ* 5кс = МОШ; 

ЕТЬЕ* Ааезе = МЫ; 

// инициализируем буфер для данных 

РВаЕЕег = пем сраг (2048 + 1}; 


1Е ( рВаЕЕек == МО) гебагп Еа15е; // нет свободной памяти 
// создаем и открываем конечный файл 
1Е ( ( ЧезЕ = Еореп ( Чез®_#Е11е, "мо")) == №0) 


{ 
// если ошибка, освобождаем память 
Че1еее [} рВчЁЕЕег; 
РВчЕЕекг = МОШ; 
гебагп ЁЕа1зе; // возвращаем ошибку 
} 
// устанавливаем курсор на начало файла 
Езеек ( Чезе, 01, ЗЕЕК_ЗЕТ); 
// открываем исходный файл для чтения 
1Е ( (эгс = Еореп ( згс Ее, "тгь")) == МОБ) 
{ 
// если ошибка, освобождаем память 
Че1еее [] рВчЕЕег; 
рВаЕЕег = МО; 
// и закрываем конечный файл 
Ес1о5е ( 4езе); 
геёагп Еа1зе; // возвращаем ошибку 
} 
// получаем размер исходного файла 
ЧмЕ11е512е = СеЕ51хеАпуЕ11е ( экс); 
// копируем данные из одного файла в другой 
ВеааЕ11ерРафа ( згс, Чезе, рВаЕЕекг, @мЕ11е512е); 
// освобождаем память 
Че1ефе [] рВиЕЕег; 
РВчЕЕег = МОШ;; 
// закрываем файлы 
Ес1о5е ( 4ез®); 
Ес1о5е ( эгс); 
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// функция успешно выполнена 
тесагп Егие; 


Кроме операций чтения и записи, в рассмотренном примере мы использо- 
вали функции Е%е11 И Езеек, чтобы определить полный размер исходного 
файла. Первая из них возвращает текушую позицию (в байтах) в открытом 
файле, а вторая устанавливает новое значение. Нехитрая комбинация этих 
функций позволила вычислить размер файла в байтах. 


Функция ЕЕЛазь используется, если необходимо немедленно сохранить дан- 
ные на диск. Она аналогична рассмотренной ранее функции Е1азВЕз1еВоЕЕегз, 
только принимает в качестве аргумента указатель на дескриптор открытого 
файла (ЕТЬЕ*). 


Для чтения или записи отдельных символов применяют функции Едекс и 
Ероес. Их наиболее ценные качества проявляются при обработке текстовых 
файлов. Например, чтобы прочитать текстовый файл в стандартный список 
(115 Вох), используйте код, показанный в листинге 20.16. Предположим, 
что в файле хранится символический плейлист (имя и путь) для музыкаль- 
ного проигрывателя. 


Листинг 20.16. Использование функции ЕдеЕс 





#1ос1аае <51о.В> 
// пишем функцию для чтения текстового файла в список 
уо1А ТюааР1ау1$е ( НИМР 614 5$ЕВох, сопзЕ сраг* Е11е) 
{ 
ЕТЬЕ* 115%; // дескриптор для файла 
10Е фпаех, сп; 
// открываем файл для чтения 
1Е ( ( ЕТлзЕ = Еореп ( Ее, "г")) != МОШ) 
{ 
// читаем данные, пока не достигнем конца ‘файла 
мп11е ( !ЕеоЕ ( Е115%)) 
{ 
// определяем буфер для данных 
сНаг +гаск[МАХ_РАТН] = ""; 
1п4ех = 0; // обнуляем счетчик 
// получаем первый символ 
сн = Едекс { Е115%); 
// если это не конец файла и не перевод на следующую строку, 
Пе ( (св != '\0') && ( ср != ЕОЕ)) 
{ 
// копируем в буфер прочитанные символы 
Ехаск[1п9ех] = ( саг) сн; 
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// получаем следующий символ 
св = Едебс ( ЕЪ15%); 
// увеличиваем счетчик 
1п4ех ++; 
} 
// добавляем строку в список 
ЗепаМеззаде ( ВТА5ЕВох, ГВ АРОЗТВТАС, 0, 
( ГРАВАМ) ( ТРСТЭТВ) &гаск); 
// переходим к следующей строке в файле 
сгаск[1паех] = 0; 
св = 0; 
} 
// закрываем файл 
Ес1озе ( #1156); 


Думаю, пример достаточно простой и не требует дополнительных коммен- 
тариев. Замечу лишь, что функция ЕеоЁ необходима для определения конца 
файла. 


Функция Ероес позволяет выполнять посимвольную запись в файл. Кроме 
дескриптора открытого файла, в качестве аргумента функция принимает 
значение одиночного символа. В листинге 20.17 представлен пример для 
записи данных из стандартного списка в файл. 





НЗ остаде <эЕЧ1о.Н> 

// пишем функцию для считывания данных из списка в текстовый файл 
У01Я ЗауеР1ау115$Е ( НИМР 2115ЕВох, соп$Е сраг* #11е) 

{ 


ЕТЬЕ* ЕЗауе; // дескриптор для файла 
СВахг БаЕ[МАХ РАТН] = " "; // буфер для данных 
сраг* рЕр; // указатель на строку 
// открываем файл для записи 
1Е ( ( ЕЗауе = Еореп ( Е11е,"м")) != МО) 
{ 
// определяем число элементов в списке 
т1Е соипе = ЗепаМеззаде ( №115%Вох, ТВ СЕТСООМТ, 0, 0); 
// запускаем цикл обработки 
Рог (ЗЕ т = 0; 1 < сомпЕ; 1++) 


{ 
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// получаем строку из списка 

ЗепаМеззаде ( №115ЕВох, 1В_СЕТТЕХТ, 1, 
( ТРАВАМ) ( ПРСТЗТВ) БаЕ); 

// устанавливаем указатель на строку 


рёг = БЕ; 
// записываем строку в файл 
м\р11е ( ( *рёг != '\0') && Ерабс ( *( рЕг++), ЕЗауе) != ЕОЕ); 


// записываем в файл перевод строки 
Ераёс ( '\п', ЕЗауе); 

} 

// закрываем файл 

Ес1о5е ( ЕЗауе); 


Как видно из примера, перед записью в файл выполняются две проверки: 
на завершающий нулевой символ и ошибку записи (ког). Это необходимо 
для исключения различных ошибок доступа. В остальном этот пример 
вполне доступен для понимания и не требует дополнительных пояснений. 


Кроме чтения отдельных символов имеется возможность считывать или за- 
писывать за один раз целую строку с помошью функций Едефёз И Гриез. Это 
позволяет немного упростить и улучшить код. Функция чтения имеет три 
аргумента: указатель на буфер данных, максимальное число считываемых 
символов и указатель на дескриптор открытого файла (ЕттЕ*). Функция 
записи определяет всего два аргумента: указатель на строку и дескриптор 
файла. В листинге 20.18 представлены примеры работы с данными функ- 
ЦИЯМИ. 


{1остаде <5Е91юо.1> 
// демонстрационный пример для чтения строки из файла 
уо1а СееЗкЕ1п9Е11е ( сопз® сваг* Е11е) 
{ 
ЕГГЕ* ЕВеаЯ; // дескриптор для файла 


сНаг РаЕ[МАХ_РАТН] = " "; // буфер для данных 
// открываем файл для чтения 
1Е { ( ЕВеаа = Еореп ( Е11е, "г")) != МОШЬ) 


{ 
// читаем строку 
у11е ( '!ЕеоЕ ( ЕВеаа)) // пока не достигнут конец файла 


{ 
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} 


// если строка прочитана, отображаем ее на экране 
1Е ( Едефз ( БаЁ, МАХ РАТН, ЕВеаЯ) != МОМ.) 
МеззадеВох ( МОШ, БаЁ, Е11е, МВ ОК); 
} 
// закрываем файл 
Ес1о5е ( ЕВеаа); 


// пример функции для записи строк в файл из списка 
\01А ЗауеР1ау14А зе ( НММР В11$ЕВох, сопзЕ сваг* Е11е) 


{ 


ЕГШЕ* Е$Зауе; // дескриптор для файла 


СВахг БаЕ[МАХ РАТН] = " "; // буфер для данных 
// открываем файл для записи 
1Е ( { ЕЗауе = Еореп ( ЕШе,"м")) != МОБ) 


{ 


// определяем число элементов в списке 
171 сочпе = бепдМеззаде ( №Ъ13ЕВох, ЪВ СЕТСООМТ, 0, 
// запускаем цикл обработки 
Бог ( 111 = 0; 1 < соипЕ; 1++) 
{ 
// получаем строку из списка 
ЗепдМеззаде { №115ЕВох, ПВ СЕТТЕХТ, 1, 
( ГРАВАМ) ( ПРСТЭЗТВ) БаЕ); 
// записываем строку в файл 
Ерие5 ( БаЕ, ЕЗауе); 
// записываем в файл перевод строки 
Ераёс ( '\п', ЕЗауе}; 
} 
// закрываем файл 
Ес1озе ( ЕЗауе); 


711 


0); 


И в завершение рассмотрим две полезные функции для записи или чтения 
из файла форматированных данных: Ерх1пЕЁ И ЕзсапЕ. Как правило, наибо- 


ных в табл. 20.1. 


лее удобно применять их в паре, т. е. вначале выполнять запись данных оп- 
ределенного формата (Ергёпе=) в файл, а затем чтение (ЕзсапЕ) из этого 
файла по строго оговоренной схеме. Обе функции имеют два обязательных 
аргумента: указатель на дескриптор открытого файла и указатель на строку с 
форматируемыми данными. Кроме этого, в зависимости от решаемой зада- 
чи пользователь может добавлять собственные аргументы. Все данные пре- 
образуются посредством специальных управляющих символов, перечислен- 
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Общий формат представления одиночного значения следующий: 


$ [флаг] [ ширина ] [. точность ] [ {В |164 | 6 |1} ] управляющий символ 


Необязательные параметры взяты в квадратные скобки. Значение флага по- 
зволяет корректировать отдельные параметры (табл. 20.2). Ширина опреде- 
ляет минимальное количество записываемых знаков и является положи- 
тельным десятичным числом. Если количество знаков в форматируемом 
параметре меньше заданного, выходное значение будет дополнено пробела- 
ми или нулями. Для задания числа знаков после запятой применяется такой 
параметр, как точность. Он будет иметь смысл только для соответствующих 
типов данных (например, Е1оае). Управляющий символ представляет собой 
определенную букву латинского алфавита, определяющую конкретный тип 
данных. 


Таблица 20.1. Управляющие символы 





Код 





символа Описание 
с или с Символ и широкий символ 
а или 1 Десятичное целое со знаком 
о Восьмеричное целое без знака 
м Десятичное целое без знака 
х или Хх Шестнадцатеричное целое без знака (строчные или прописные сим- 
волы) 
е или Е Экспоненциальное значение (строчные или прописные символы) 
Е Значение с плавающей точкой 
п Указатель на целое значение, определяющее число символов, выве- 
денных в поток на текущий момент 
р Адрес, на который указывает аргумент 
$ ИЛИ 5 Символьная строка 





Таблица 20.2. Список флагов 


Флаг Описание 
- Выравнивание по левому краю 
+ Добавление знака, если аргумент знаковый 


# Для шестнадцатеричных чисел выводится префикс Ох, 
а для восьмеричных — 0 


0 Дополнение нулями до заданной ширины 
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В листинге 20.19 приведены различные примеры работы с данными функ- 
ЦИЯМи. 





Листинг 20.19. Использование функций ЕреалЕЕ и ЕзсапЕ 


Н1ос1ае <5Е91о.В> 
// переменные 
ЕТЬЕ* ЕТрт = МОБ; 
СВаг* Сепега1 = "Сепега1 Зета"; 
ПЕ х = 50, у= 78; 
ОМОКО ЧмНех = 2489451; 
срак сн = '\'!; 
РМОВО ЧимУа1ие = 9802348; 
Е]оаЕ ЕЕгеа = 2350.345; 
// создаем новый текстовый файл 
1Е ( ( ЕТот = Еореп ( "Е: \\МузЗееЕ1та$. 111", "м")) != МО) 
{ 
// записываем строку в файл 
ЕрезпеЕ ( ЕТп1, "%3\п\п", бепега1); 
// записываем целые значения в файл 
ЕрелпеЕ ( ЕТп1, "МЗАеА = %1\пНелане = %а\п", х, у); 
// записываем шестнадцатеричное значение в файл 
ЕрезпеЕ ( ЕТо1, "Мепогу АЧдгез$ = 0х%х\п", амНех); 
// записываем символ в файл 
ЕргапеЕ ( ЕТп1, "Ассезз = %с\п\п", сп); 
// записываем строку в файл 
ЕрелпеЕ ( ЕТп1, "[МебмогКк 3е%119$]\п\п"); 
// записываем длинное целое значение в файл 
ЕретпЕЕ ( ЕТп1, "Соапё = %1а\п", амУа1че); 
// записываем число с плавающей точкой в файл 
ЕрезпЕЕ ( ЕТл1, "Егеааепсе = $4.32", ЕЕЁгеа); 
} 
// закрываем файл 
Ес1озе (ЕТ); 
// открываем файл для чтения 
1Е ( ( ЕТпь = Еореп ( "Е: \\Музесе119$.101", "г")) != МОБ) 
{ 
// получаем значения из файла 
СсВаг 54Е[18] =" "; 
// читаем строку из файла 
ЕзсапЕ ( ЕТп1, "%5", БаЕЁ); 
// читаем целые значения из файла 
ЕзсапЕ ( ЕТп1, "%1%4", &х, &5у); 
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// читаем шестнадцатеричное значение из файла 
ЕзсапЕ ( ЕТп1, "0х$х", &амНех); 
// читаем символ из файла 
ЕзсарЕЁ ( ЕТр1, %с", &с1); 
// читаем длинное целое значение из файла 
ЕзсапЕ ( ЕТр1, "$1а", &АмУа1ае); 
// читаем число с плавающей точкой из файла 
ЕзсапЕ ( ЕТп1, "%4.3Е", &ЕЕгеа); 

} 

// закрываем файл 

Ес1озе (Ё1Тр1); 


В этом примере мы создали файл настроек (111) и записали в него различ- 
ные параметры. После открыли этот же файл для чтения и, получив необ- 
ходимые значения, сохранили их в соответствующих переменных. Естест- 
венно, в реальной программе операции записи или чтения файла следует 
выполнять по мере необходимости. 


20.2. Сжатые файлы 


Несмотря на постоянное удешевление устройств хранения данных и увели- 
чение их объема, программы сжатия файлов остаются достаточно популяр- 
ными и широко используемыми во всем мире. И основной причиной этого 
является, конечно, обмен информацией в глобальной сети Интернет. По- 
этому я и решил немного познакомить читателя с поддержкой сжатых фай- 
лов в \Уш9дом5. 


Интерфейс \!М!т32 АРЕ содержит набор функций для декомпрессии файлов, 
сжатых с помошью программы Сотргез$.ехе: 1,20репЕ11е, 12Сору, 17С1озе, 
.25еек, .7Веаа И СбесЕхрапаеЯМане. 


Функция 120репЕ!11е позволяет создать, открывать и удалять указанный 
файл. Она имеет три аргумента: имя файла, указатель на структуру оЕЗТВОСТ 
и тип выполняемой операции. Как правило, эта функция вызывается дваж- 
ды: для открытия сжатого файла и для создания нового восстановленного 
файла. После того как оба файла открыты, применяется функция т2сСору, 
которая восстанавливает сжатые данные исходного файла и копирует их в 
конечный файл. По завершении работы следует закрыть используемые фай- 
лы с помошью функции 12С1озе. Если требуется восстановить только часть 
(части) сжатого файла, можно воспользоваться функциями 125еек И 17Веаа. 
Также существует возможность получить оригинальное имя сжатого файла 
с помошью функции сесЕхрапаеаМате. В листинге 20.20 представлен пример 
работы с функциями декомпрессии файлов. В опциях компоновщика не 
забудьте добавить ссылку на библиотеку 1232.15. 
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#1пс1аае <12ехрапа. > 

// пишем функцию для восстановления сжатого файла 

500] ОпСопргеззЕ41е ( сопз® сВаг* згс Е11е, сопзЕ спаг* Чез+_Е11е) 
{ 


НЕТЬЕ ЮСопргезз = МОБ, РВезбкоге = МОМ); // дескрипторы файлов 
ОЕЗТВОСТ оЁЗгс, оЁБезе; // структуры для описания файлов 
// открываем исходный файл для чтения 
ВСопргезз = Ъ2ОрепЕ11е ( згс _Е11е, &0ЕЗгс, ОЕ _ВЕАО); 
// создаем новый файл 
БВезбоге = 12О0рерЕ11е ( 4езЕ_Е11е, &оЕБезе, ОГ СВЕАТЕ); 
// выполняем декомпрессию исходного файла 
1Е ( ГАСору ( ЬСопргезз, НВезбоге) < 0) 
{ 
// произошла ошибка 
Т7С]1озе ( ВСопргез$); 
Т2С1озе( БВезеоге); 
гесаго Еа1зе; // выходим из функции с ошибкой 
} 
// закрываем оба файла 
Т2С1озе ( №Сопргезз); 
12С]озе( РКезкоге); 
// выходим из функции 
тесагп Егоае; 
} 
// пишем функцию для получения оригинального имени сжатого файла 
Бо01 Сбесг11еСотргеззМаме ( сваг* эзгс Ё11е, спаг* ог191па1 паще) 
{ 
1Е ( СбесЕхрапде Мане ( згс_ Ё11]е, ог191па1 паще) != 1) 
гебаго Еа1зе; // произошла ошибка 
// выходим из функции 
гебигп +гие; // ошибок нет 


А теперь попробуем написать собственный кодек для сжатия файлов любого 
типа. Основной принцип его работы будет построен на исключении повто- 
ряющихся символов в файле. Для упрощения работы создадим новый класс 
Сопргезз. Необходимые файлы класса представлены в листингах 20.21 
и 20.22. 





Листинг 20.21. Файл Сотрге5$.М 
#1ос1оае <зЕ41о.н> 


// размер буфера 
заеЕ1ле ВОЕЕЕВ_$Т2Е 327680 
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// размеры данных 
#АеЁ1пе ТМР_$12Е_4 4 
#ЧеЕ1пе ТМР_$Т2Е_8 8 
// объявления класса 
с1аз$ Сошргезз 
{ 
раБ11с: 
Сопргезз (); // конструктор 
-Сопргезз (); // деструктор 
// общие функции 
// функция для компрессии файла 
уо1А 21рЕ11е ( сопзЕ сваг* 4п Ее, сопзЕ сваг* 21р Е11е); 
// функция для декомпрессии файла 
%01А 0121рЕ11е ( сопзЕ сваг* 21р Е11е, сопзе сваг* обе Ее); 
ре1уаее: 
ЕГЬЕ* 10 Ее, *оче Е11е; // дескрипторы файлов 
сваг* БаЕЕег; // указатель на буфер 
// закрытые функции 
У01А _сопргезз (); // сжать файл 
\014 _аесопргезз (); // восстановить сжатый файл 
// вычислить 16-разрядное значение 
и1319плеа 106 _десУа1ае ( ипз19ле@ саг рагам1, ипз1дпе@ сраг рагап2); 
}; // окончание класса 





#1ос1таае "зЕЧаЁх.Ь" 
// реализация класса Сотргезз 
Сотргез$ :: Сопргезз () 
{ 
// инициализируем переменные 
11 Е11е = МОБ; 
о _Е11е = МО; 
// выделяем память под буфер 
БаЕЕег = пем сраг [ВОЕГЕК_5Т2Е]; 
1Е ( 'роЕЁЕег)} гебако; 
} 
Сопргезз :: -Сопргез$ () 
{ 
// освобождаем память 
1Е ( раЕЁЕег) ае1ебе [] РоЕЕег; 
п Е11е = МО; 
ое _Е11е = №; 
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90$1апеЯ 11е Сошргезз :: _дебУа1ае ( ипз19пеа сваг рагап1, 
и103191е сваг рагам2) 


гебаго ( ( ( 0пз1апеа) рагап] << 7) ^ рагам2); 
} 
у01А _сопргезз () 
{ 
1Е (111 Ее || !очё Е11е) гебаги; 
// определяем необходимые переменные 
9п310пе сВаг уа1\1е=0; 
ип31опеа 116 1пдех = 0; 
Сваг Нтр[ТМР_$17Е_4]; 
106 СЪ, 1, соцлЕ = 0, роз = 0; 
сраг св 1 = 0, св 2 = 0; 
// заполняем буфер символом АЗСТТ с кодом 32 
пешзее ( раЕЁег, 32, ВОЕЕЕВ_5Т7Е); 
// читаем первый символ из входного файла 
св = Едеес ( 11 211е}; 
// обрабатываем файл, пока не достигнем конца 
ур11е ( ср != ЕОР) 
{ 
// вычисляем 16-разрядное значение 
1п4ех = _декУа1ае ( сп 1, св 2); 
// проверяем совпадение прочитанного символа с буфером 
1Е ( РоЕЁЕег[1п4ех] == ( сваг) сп) 
{ 
// устанавливаем признак совпадения 
уа1ае = уа1оае ^ (1 << созп®); 
} 
е1зе 
{ 
// сохраняем символ в буфер 
раЕЕег [1п04ех] = ( сваг} сь; 
// сохраняем символ во временном буфере 
+пр[роз++] = ( сраг) св; 
} 
// проверяем заполнение временного буфера 
1Е ( ++сочре == ТМР $512Е_4) 
{ 
// записываем признак в файл 
Ераес ( ( сВаг) уа]ае, оч. Ё11е); 
// записываем в файл символы из временного буфера 
Бог ( 1=0; 1 < роз; 1++) 
Ераёс ( р[1], оче_Е11е;); 
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// обнуляем переменные перед следующим использованием 
соцпЕ = 0; 
ро$ = 0; 
уа]1е = 0; 
} 
св 1 = св 2; 
сВ_2 = ( сраг} сй; 
// читаем следующий символ из файла 
сЬ = Едебс ( 11 Е11е); 
} 
// если есть остатки, записываем их в файл 
1Е ( соцрЕ) 
{ 
// записываем управляющее значение 
Еробс ( ( саг) уа1ае, обе Е11е); 
// записываем символы 
Бог ( 1=0; 1 < роз; 1++) 
Ериес ( ЮаЁ[1], оче Е11е); 


Я Сотргезз :: _аесотргезз () 


ЗЕ (110 Ее || !04Е Е1]е) гебагп; 
// определяем необходимые переменные 
\215$19пеЯ сраг уа1ае=0; 
и1$19пе 116 1паех = 0; 
сваг св 1 = 0, св 2 = 0; 
106 с51, св2, сойпе = ТМР_$12Е_4; 
// заполняем буфер символом АЗСТТ с кодом 32 
петзее ( раЁЕЁег, 32, ВОЕГЕВ_ЗТ2Е); 
// читаем первый символ из входного файла 
св1 = Едесс ( 11 Е11е); 
// обрабатываем файл, пока не достигнем конца 
\Б11е ( сь1 != ЕОЕ) 
{ 

// получаем признак совпадения 

уа1ае = ( чпз1апеа сВак) ( саг} ср]; 

// выполняем обработку для каждого бита признака 

Рог ( сое = 0; соапе < ТМР 5Т2Е_4; соипё++) 

{ 

1Е ( уа1ае & (1 << содпе;})} 
{ 
// вычисляем 16-разрядное значение 
1п4ех = _деЕ\а]ае ( св_1, св_2); 
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// читаем символ из буфера 
ср2 = раЕЕег [1п4ех]; 
} 
е1зе 
{ 
// читаем следующий символ 
св2 = Едебс ( ш Ее); 
// если конец файла, выходим из функции 
1Е ( сЬ2 == БОЕ) гебаго; 
// вычисляем 16-разрядное значение 
1п4ех = _дебсУа1ае ( сп 1, с® 2); 
// сохраняем символ в буфер 
раЕЕег [1п4ех] = ( сваг) сВ2; 
} 
// записываем восстановленный символ в конечный файл 
Ерабс ( сб2, оч Е11е}; 
// копируем значения 
св_1 = с® 2; 
св_2 = с12; 
} 
// читаем следующий символ из файла 
св1 = Едекс ( т _Е11е}; 


} 
уо1А Сотргезз :: 21рЕ11е ( сопз®& спаг* 1п Е1]е, сопзЕ сваг* 71р Е11е) 
{ 
// открываем файл 
1Е ( (ам Ее = Еореп ( 40 Ее, "кь")) == №0) 
тееагп; // не удалось открыть файл 
// создаем конечный файл 
1Е ( ( ощё ЕПе = Еореп ( 21р_Е11е, "мь")) == МОБ) 
{ 
Ес1озе ( 1п_Е1е); 
гесаго; // не удалось открыть файл 
} 
// выполняем сжатие файла 
_сотргезз ( 1п Ее, обе [11е}; 
// закрываем файлы 
Ес10зе ( 1п Е11е); 
Ес1озе ( обе _Е11е); 
211 Ее = МЫ; 
оиЕ Е11е = МЫ; 
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уо1А 9171рЕ11е ( сопз® сваг* 21р_Е11е, сопзЕ спаг* оч Е11е) 
{ 
// открываем сжатый файл 
1Е ( (17 Е11е = Еореп ( 21р Ее, "хЪ")} == М) 
гесогп; // не удалось открыть файл 
// создаем конечный файл 
1Е ( ( оаЕ Е11е = Еореп ( оч Р41е, "мБ")) == №Ы,) 
{ 
Ес1озе ( 1т_Е11е); 
гефагп; // не удалось открыть файл 
) 
// выполняем декомпрессию сжатого файла 
_Чесотргезз ( 11 _Е11е, очё Е11е); 
// закрываем файлы 
Ес1о5е ( 11 _Е11е}; 
Ес]о5е ( очЕ Е11е); 
1п_Е11е = М; 
оцЕ Е11е = МЫ; 


У нас получился несколько примитивный, но вполне работоспособный 
класс, позволяющий сжимать любые типы файлов. Используемый алгоритм 
сжатия не является уникальным и достаточно широко известен, но для на- 
чинающих программистов он будет очень полезен как демонстрация одного 
из методов сжатия данных. К сожалению, его эффективность заметна толь- 
ко при работе с текстовыми файлами (5, дос и др.). 


20.3. Шифрование файлов 


Для защиты файлов и каталогов от нежелательного доступа интерфейс 
У п32 АР| предусматривает возможность шифрования файловых объектов. 


Если в операционной системе \УЛпдо\5 2000 установлена файловая система 
МТЕ$, можно организовать защиту с помошью следующих функций: 
Е11еЕпсгуре+оп$касаз (получение статуса файла), ЕпскуреЕЛе (шифровка 
файла), ресгуреЕ11е (дешифровка файла) и ЕпсгурЕ1опр1заБ1е (управление 
защитой). Эти функции поддерживают шифрование не только файлов, но и 
каталогов. Если необходимо создать новый зашифрованный файл, доста- 
точно вызвать функцию сгеа%еЕ11е с флагом еТТЕ АТТВТВОТЕ ЕМСВУРТЕР. 


Функция Е11еЕпсгурЕ1оп3+аеаз позволяет определить, является ли зашифро- 
ванным указанный файл. Первый аргумент определяет имя файла, а второй 
получает результат выполнения функции. Для проверки статуса файла из 
полученного значения выделяются флаги ЕТТЕ_1$ ЕМСВУРТЕР (файл зашифро- 
ван) или ЕТТЕ ЕМСВУРТАВЬЕ (файл может быть зашифрован). 
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Функция ЕпсгурЕЕ11е выполняет шифровку заданного файла или каталога. 
Все вновь создаваемые файлы в зашищенном каталоге будут зашифрованы. 
Единственный аргумент функции определяет имя файлового объекта. Для 
корректной работы функции требуется монопольный доступ к файловому 
объекту. 


Функция Ресгур®Е11е восстанавливает зашифрованный файл или каталог. 
Она имеет два аргумента, первый из которых определяет имя файла или 
каталога, а второй зарезервирован. Для корректной работы функции требу- 
ется монопольный доступ к файловому объекту. 


И последняя функция ЕпскурЕопр1заю1е служит для блокировки каталога с 
файлами от нежелательной шифровки. Первый из двух аргументов функции 
указывает на путь к каталогу, а второй отключает или включает режим бло- 
кировки. 


В листинге 20.23 представлены примеры работы с вышеупомянутыми функ- 
ЦИЯМИи. 


: Листинг 20.23. Шифрование файлов в У/п4о\з 2000 





#1рос1аае <Мараомч$.В> 
#1пс1а4е <Мпьазе.в> 
// пишем функцию для шифрования существующего файла 
Боо1 _епсгурЕЕ11е ( сопз® спаг* Ё11е) 
{ 
БМОВЬ ам5$баеа$ = 0; 
// проверяем статус файла 
1Е ( !Е11еЕрскурЕ1оп5аеаз ( Е1]е, &Амбфаказ)) 
гекагп Еа1зе; // ошибка 
// выделяем значение ЕТТЕ 15$ ЕМСВУРТЕР 
1Е ( амЗсабаз & ЕГЕ 15$ ЕМСВУРТЕО) == ЕТШЕ 1$ ЕМСВУРТЕО) 
геёагп &гое; // файл уже зашифрован 
// выполняем шифровку файла 
1Е ( 'Епскур®Е11е ( ЕШе)) 
гесигп Еа1зе; // произошла ошибка 
// выходим из функции 
тебсагп &гое; 
} 
// пишем функцию для дешифровки существующего файла 
роо1 _ЗесгурЕЕ11е ( сопз®Е сваг* Е11е) 
( 
БИОВР 9м5еаеа$ = 0; 
// проверяем статус файла 
1Е ( !Е11еЕрскур®1оп5б$ а аз ( Е11]е, &ам5бабсаз))} 
гебакп Еа1зе; // ошибка 
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// выделяем значение РТШЕ 1$ ЕМСКУРТЕВ 
1Е ( Чмзфасаз & ГТЬЕ_Т5$ ЕМСВУРТЕЬ) != ЕТШЕ 1$ ЕМСВУРТЕО) 
гебигп гие; // файл не зашифрован 
// выполняем дешифровку файла 
1Е ( '!Бесгур®Е11е ( Е11е)) 
гебагп Еа1зе; // произошла ошибка 
// выходим из функции 
гебаго Егое; 
} 
// пишем функцию блокировки для указанного каталога 
роо1 ТоскКЕрсгурЕЕ1]ез ( ЬРСИЗТВ 1рРаёВ, Боо1 Боск) 
{ 
1Е ( 'ЕпсгурЕ1опр1заб]1е ( 1рРаёЪ, БГосКк)) 
гебигп Еа1зе; // ошибка 
// выходим из функции 
гебагп $гоае; 


Кроме представленных возможностей шифрования, существует отдельный 
интерфейс для защиты файловых объектов, который поддерживается всеми 
операционными системами УМ тдо\5. Мы не будем рассматривать его цели- 
ком, поскольку для этого не хватит и всей книги, а разберем только базовые 
средства для шифрования различных типов файлов. 


Создайте каркас нового класса и назовите его, например, скуркоЕ1Ле. За- 
полните оба файла класса так, как это сделано в листингах 20.24 и 20.25. Не 
забудьте указать в опциях компоновщика ссылку на библиотеку А4уар!32.1Ъ. 





// подключаем определения специальных типов данных 
фуредеЕ ипз1опеа 1опу НСКУРТРВОУ; 

фуредеЕ чпз1дпеа 1опду НСВУРТКЕУ; 

фуредеЁ опз1дтеа 1опд НСВУРТНАЗН; 

// типы кодеков, поддерживающие потоковую обработку файлов 
#+ЧеЕ1пе СОБЕС_ РЕЗ САШб 0ЕЗ 

#аеЁ1пе СОБЕС ВС2 САС ВС2 

#аеЁ1пе СОБЕС_ВС4 САБС_ВС4 

// размер блока данных 

#ЧеЕ1пе ВГОСК ТЕ 8 

// объявляем класс 

с1азз СкурвоЕ11е 

{ 
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рир]11с: 
СкурЕоЕ11е (}; // конструктор 
-Сгур®оЕ11е (); // деструктор 
// общие функции 
// функция шифрования файлов любого типа 
Боо1 Епсгуре ( сопз®е сваг* згс_ЁЕ11е, сопзЕ сВаг* Чез&_Ее, 
сопзЕ сраг* Раззмога, роо1 ЮСкеакеКеу); 
// функция для дешифровки файлов любого типа 
Боо1 БесгурЕ ( сопз$Е сваг* згс _Е11е, сопзЕ сваг* ЧезЕ Е11е, 
сопзЕ сВаг* Раззмога, роо1 ЮСгеавеКеу); 
ре1уаее: 
// переменные класса 
ЕТЬЕ* м згс Ё11е; // указатель на файл источника 
ЕТТЕ* ш 4ез< Ё11е; // указатель на файл назначения 
НСКУРТРКОУ м Ргоу1Чек; // дескриптор доступа 
НСВУРТКЕУ п _Кеу; // дескриптор ключа 
НСВУРТНАЗН ш Назв; // дескриптор хэширования 
// закрытые функции класса 
Роо1 _сгеафеКеу (); // функция для автоматической генерации ключа 
// функция для восстановления сгенерированного ключа 
Боо1 _геааКеу (); 
}; // окончание класса 


Листинг 20.25. Файл Сгур®юЕНе.срр 





// необходимые файлы подключений 
#1остоае "зедаЁх.в" 
#1осТоаде <зЕ91о.1> 
#10с1о4е <игпскуре.П> 
Н1ос1аае "СгурхоЕ11е.в" 
// реализация класса 
Сгур®оЕ11е :: СкурбоЕ11е () 
{ 
// обнуляем переменные класса 
п_эгс ЕПе = МЫ; 
п Чезе Е11е = М0; 
п Ргоу1Аег = 041; 
п _Кеу = 091; 
м НазВ = 041; 
} 
Сгур®оЕ11е :: -СкгурвоЕ11е () 
{ 
// освобождаем указатели 
м эгс Е11е = МО; 


} 
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м Чез®е_Е11е = М0; 


Боо1 СгуртоЕЁ1е :: _сгеабкеКеу () 


{ 


НСВУРТКЕУ ОзегКеу = 0%1; // дескриптор пользовательского ключа 
ОИОВР @мЪепКеу = 0; // длина ключа 
РВУТЕ рКеу = МОШЬ; // указатель на буфер данных 
// генерируем случайный ключ 
1Е ( !СгурЕбепКеу ( м Ргоу14ег, СОБЕС _0Е$, СВУРТ ЕХРОВТАВЦЬЕ, 
&п Кеу)) 
тегигп Ра15е; // ошибка 
// получаем дескриптор пользовательского ключа 
1Е ( !СгурЕбеОзегКеу ( м Ргоу14ег, АТ КЕУЕХСНАМСЕ, &0ОзегКеу)) 
гесиагп Ра15е; // ошибка 
// определяем размер ключа 
1Е ( !Сгур&ЕхрогЕКеу (м Кеу, ОзегКеу, ЗТМРЬЕВЬОВ, 0, МОИ, 
&амЪепКеу) } 
гефагп Еа15е; // ошибка 
// выделяем память 


рКеу = ( ВУТЕ*) тша11ос ( амепкеу); 
// проверяем результат 
1Е ( !рКеу) 


{ 
// удаляем дескрипторы 
1Е ( ОзегКеу) СгурБезегоуКеу ( ОзегКеу); 
гебогп Ра1зе; // ошибка 
} 
// шифруем ключ и экспортируем для рабочего ключа 
1Ё ( 'СгурЕЕхрогеКеу ( м Кеу, ОзегКеу, 5ЭТМРЬЕВЬОВ, 0, рКеу, 
&амЪепКеу) ) 


// удаляем дескрипторы 
1Е ( ОзегКеу) Сгур®БезегоуКеу ( ОзегКеу); 
гебагп Ра1зе; // ошибка 
} 
// удаляем пользовательский ключ 
СгурЕБезегоуКеу ( ОзегКеу); 
ОзегКеу = 041; 
// записываем размер ключа в файл назначения 
Еиг1се ( &АмТепКеу, з12еоЕ ( ОМОВО), 1, м Аезе Е11е); 
// записываем значение ключа в файл 
Еиг1 се ( рКеу, з12еоЁ ( ПОМОВО), 1, м Чезх Е11е); 
// освобождаем память 
1Е ( рКеу) Егее ( рКеу); 
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} 


// выходим из функции 
тефагп ©гае; 


Боо1 СгуртоЕШе :: _геааКеу () 


{ 


} 


Боо1 СкурбоЕ11е :: 


ОИОВР @мЪепКеу = 0; // длина ключа 

РВУТЕ рКеу = МОШ.; // указатель на буфер данных 

// читаем из исходного файла значение длины ключа 
Егеаа ( &амТепКеу, 312еоЕЁ ( ПМОВР), 1, м згс Е11е); 
// если обнаружен конец файла, выходим 

1Е ( ЕеоЕ ( м экс Е1е)) гебакп Ра1зе; 

// выделяем память для значения ключа 


рКеу = ( ВУТЕ*) пша11ос ( @мТепКеу); 
// если отказано в выделении памяти, выходим 
1Е ( !рКеу) гебагп Еа1$е; 


// читаем значение ключа из исходного файла 
Гтеаа ( рКеу, 1, @м1епКеу, м згс Е11е); 
// если обнаружен конец файла, выходим 
1Е ( ЕеоЕ ( м эзгс Е11е)) гебагп Еа1зе; 
// восстанавливаем дескриптор ключа 
1Е ( 'СгуреПарогКеу ( м Ргоу1Чег, рКеу, ЯмТепКеу, 0, 
{ 

// освобождаем память 

1Е ( рКеу) Егее ( рКеу); 

тебагп Еа1зе; // ошибка 

} 
// освобождаем память 
1Е ( рКеу) Егее ( рКеу); 
// выходим из функции 
тесагп гие; 


О, &м Кеу) } 


соп5®& сваг* Раз$могА, Боо1 БСгеакеКеу) 


ОМОВО амРаба\еп = 0, АмВоЕЕекеп = 0, @мВеаЯВуеез = 0; 


} 

РВУТЕ рВаоЁЕЁЕег = №11; // указатель на буфер данных 
Ъоо1 ЬВези16 = ©кце; // результат операции 

// открываем исходный файл 


1Е (( мтс Ее = Еореп ( эгс Ее, “хЬ")) == МОШ) 


териогп Еа15е; // ошибка 
// открываем конечный файл 


1Е (‘См Чезе Е11е = Еореп ( Чез® Е11е, "мь")) == МОБ) 


{ 


Ес1озе (м згс Ее); 
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Епсгуре ( сопзЕ сНаг* згс Е11е, сопзЕ спаг* Чезе Ее, 
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гебагп Еа1зе; // ошибка 
} 
// получаем дескриптор доступа по умолчанию 
1Е ( !Сгур®Асаа1геСопеехе ( за Ргоу1аег, МОШ., МОШЬ, РВОУ ВЗА ЕОШ., 
0) } 


ЬВез1е = Еа1зе; // ошибка 
дофо ех1{_ еггог; 
} 
// если требуется, генерируем ключ 
1Е ( БСгеафеКеу) 
{ 
1Е (! сгеабекеу ()) 
{ 
ЬВез1е = Еа1зе; // ошибка 
дофо ех1& еггог; 
} 
} 
е1зе 
{ 
// инициализируем дескриптор хэширования для потока данных 
1Е ( 'СгуреСгеакеНазВ ( м Ргоу1Аег, САЬС МО5, 0, 0, вм НазВ) )} 
{ 
ЪВези16 = Еа15е; // ошибка 
дово ех1& еггог; 
} 
// обрабатываем заданный пароль 
1Е ( !СгурЕНазбБата ( м Назб, ( ВУТЕ*) Раззмога, 
зЕх1еп ( Раззмога), 0)) 


ЬВеза16 = Ёа1зе; // ошибка 

дофо ех1{_ еггог; 
} 
// генерируем ключ на основе пароля 
1Е ( !СгурЕрегфуеКеу ( м Ргоу1Аег, СОБЕС РЕЗ, м Назр, 0, &м Кеу)) 
{ 

ЬВез016 = Ёа1зе; // ошибка 

досо ех1& еггог; 
} 
// удаляем дескриптор хэширования 
СгурРезегоуНазВ ( м Наз1); 
п Назь = 051; 
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// вычисляем число байтов в одном блоке данных 
@Рафа1еп = 1000 - 1000 % ВТОСК $1Т7Е; 
// вычисляем размер блока данных 
1Е ( ВЬОСК_5Т2Е > 1) 
ЧмВиЕЕегЬеп = @мбабафеп + ВШОСК $12Е; 
е1зе 
ОмВиЕЕегеп = ЧмБафа!еп; 
// выделяем память 
РВаЕЁег = ( ВУТЕ*) па]]ос ( амВаЕЕет!еп); 
// проверяем результат 
ТЕ ( 'РВУЕЕег) 
{ 
ЬВези1& = Еа1зе; // ошибка 
доео ех1® еггог; 
} 
// шифруем исходный файл 
ао 
{ 
// читаем блок данных из исходного файла 
ЯмВеааВуее$ = Ёгеаа ({ рВаЕЕег, 1, @мбафха\еп, м_згс Е11е); 
// шифруем блок данных 
1Е ( !Сгур&Епсгур® ( м Кеу, 0, ЕеоЕЁ ({ м згс Е11е), 0, рВУЕЕег, 
&ЧиВеаЯВуеез, 9мВоЁЁег!еп)) 


ЬВез16 = Ёа1зе; // ошибка 
дофо ех1{ еггог; 
} 
// пишем зашифрованный блок данных в конечный файл 
Еуг1 се ( рВаЕЁег, 1, ЧмВеаЧВукез, м Чез*_#Е11е); 
// переходим к чтению следующего блока данных 
} мр1е ( '!ЕеоЕ ( м згс Е11е)); 
// метка для обработки выхода из функции 
ех1{Е_еггог: 
.// освобождаем память 
1Е ( рВоЕЁЕег) Егее ( рВуЁЁег); 
// закрываем файлы 
1Е (м з+с Е1]е) Ес1озе (м згс Е11е); 
1Е (м Чезе Е11е) Ес1озе ( м Чезе Е11е); 
// удаляем ключ 
1Е (м Кеу) Сгур%БезегоуКеу (м Кеу); 
// удаляем дескриптор хзширования 
1Е (м Назр) СгуреБезегоуНазВ ( м НазВ); 
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// удаляем дескриптор доступа 
1Е ( м Ргоу1Аег) Сгур&Ве1еазеСопеехе ( м Рго\у1аег, 0); 
// обнуляем переменные 
и_зкс Ее = МОШ; 
м Чезе Е11е = №; 
м Ргоу1Аег = 041; 
м Кеу = 041; 
шп _НазЬ = 041; 
// выходим из функции 
тесогп РВезо1; 
} 
Боо1 СгурбоЕ11е :: БесгурЕ (сопзе сваг* згс Ё11е, сопзе сваг* Чезе Е11е, 
соп$Е сраг* Раз$мога, Боо1 БСгеакеКеу) 


РИОВР ЧмрафаЬеп = 0, амВоЕЕегеп = 0, амВеааВуфев = 0; 
РВУТЕ рВаЁЕЁег = МОШ.; // указатель на буфер данных 
Боо1 РВеза1Е = Егце; // результат операции 
// открываем исходный файл 
1Е (( мтс Ее = Еореп ( згс Ее, "ть")) == МОШ) 
гебагп Еа1зе; 
// открываем конечный файл 
1Е ( (м Чезе Е11е = Еореп ( аез®_Е11е, "мЬ")} == №0.) 
{ 
Ес]1озе (м згс Е11е); 
тебагп Ра13е; // ошибка 
} 
// получаем дескриптор доступа по умолчанию 
1Е ( !СгурхАсаа1геСопеехе ( &м Ргоу1Аег, МОБ, МОЬЬ, РВОУ ВЗА_ РОТ, 
0) ) 


ЬВеза1е = Еа1зе; // ошибка 
аофо ех1*_еггог; 
} 
// если требуется, генерируем ключ 
1Е ( ЬСгеафеКеу) 
{ 
1Е ( ! геааКеу ()) 
{ 
ЬВезо1е = Ёа1з5е; // ошибка 
досо ех1® еггог; 
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е1 зе 
{ 
// инициализируем дескриптор хэширования для потока данных 
1Е ( !Сгур&СгеасеНазь ( м_Ргоу1Аег, САШС МО5, 0, 0, ба Назь)) 
{ 
ЪВез01& = Ёа1зе; // ошибка 
дото ех1®_еггог; 
} 
// обрабатываем заданный пароль 
1Е ( '!СгуреНазВРафа ( пм Назр, ( ВУТЕ*) Раззмога, 
36х]еп ( Раззмога), 0)) 


ЬВез01Е = Ёа15е; // ошибка 
9ово ех1&_еггог; 
} 
// генерируем ключ на основе пароля 
1Е ( 'СгуреОбег1уеКеу ( м Ргоу1Аег, СОРЕС РЕЗ , м НазВ, 0, 
&т _Кеу)) 


ЬВезц1Е = ЁЕа1зе; // ошибка 
Чо®о ех1е еггог; 
} 
// удаляем дескриптор хэширования 
СгуреОезфгоуНазН ( м НазПв); 
м Назр = 051; 
} 
// вычисляем число байтов для шифровки за один проход 
@ЧРафа!еп = 1000 - 1000 % ВГОСК_5Т7Е; 
// размер блока данных 
ЧмВоЕЁегЬеп = ЧмБаеа!еп; 
// выделяем память 
рВоЕЁЕег = ( ВУТЕ*) па1]ос ( ЧмВуЕЕегГеп); 
// проверяем результат 
1Е ( !рВоЕЁЕег) 
{ 
БЬВезц1е = ЁЕа1зе; // ошибка 
Чофо ех1{_еггог; 
} 
// дешифруем исходный файл 
ао 
{ 
// читаем блок данных из исходного файла 
@ВеаЧВукез = ЁЕгеаА ( рВаЁЁЕег, 1, АмРаба еп, м_згс Ё11е); 
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// дешифруем блок данных 
1Е ( '!Сгурересгуре (м Кеу, 0, ЕеоЁ ( м згс Ее), 0, рВаЕЕег, 
&ЧмВеааВукез) ) 


ЪЬВези1+ = Ёа15е; // ошибка 
дово ех1{ еггог; 
} 
// пишем дешифрованный блок данных в конечный файл 
Емг1се ( рВчЁЁег, 1, ОмВеаЧВукез, м Чезе Е11е); 
// переходим к чтению следующего блока данных 
} пе ( 'ЕеоЕ (м эгс Е11е)); 
// метка для обработки выхода из функции 
ех1_еггог: 
// освобождаем память 
1Е ( рРВУЕЕег) Егее ( рВаЕЁег); 
// закрываем файлы 
1Е (м эгс Е11е) Ес1озе ( м зэгс Ее); 
1Е ( м ЧезЕ Е11е) Ес1озе ( м 4ез® Е11е); 
// удаляем ключ 
1Е (м Кеу) Сгур&БезегоуКеу (м Кеу); 
// удаляем дескриптор хзширования 
1Е ( м НазВ) СгурЕ/езегоуНазь ( м НазВ); 
// удаляем дескриптор доступа 
1Е ( м Ргоу1Аег) СгурЕВе1еазеСопфехе ( м_Ргоу1аег, 0); 
// обнуляем переменные 
м 5гс Е11е = №Ы;; 
м ЧезЕ Е11е = МОШ; 
п _Ргоу1Аег = 0%1; 
ш Кеу = 0%1; 
п НазВ = 041; 
// выходим из функции 
гесогп РВезы1<; 


Прежде чем компилировать созданный класс, откройте файл 5{ЧаБк.И и до- 
бавьте после #аеЁ1пе иИ1432 ТЕАМ АМОР МЕАМ указатель версии в виде строки 
#4е1пе 1932 ИТММТ 0х0400. Если вы используете оболочку \У15а| 
Зпаю .МЕТ, делать это не обязательно. 


Класс СгурсоЕ\ле поддерживает три алгоритма шифрования: ОЕЗ (56-бит- 
ный ключ), КС2 (128-битный ключ) и КС4 (128-битный ключ). Для обра- 
ботки файлов используются две функции: Епскур® И Бесгуре. Они имеют по 
четыре схожих аргумента: имена исходного и конечного файлов, указатель 
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на установленный пользователем пароль и режим генерации ключа. Если 
с первыми тремя аргументами все ясно, то последний требует пояснения. 
С его помощью можно определять способ создания ключа. При установке 
значения этого параметра в ТВОЕ заданный пароль не будет использоваться, 
а ключ будет сгенерирован автоматически, иначе ключ составится на основе 
введенного пользователем пароля. Создание и получение автоматически 
сгенерированного ключа выполняют функции _сгеафеКеу И _геаЯКеу. 


Шифрование файлов организовано с помощью следующих библиотечных 
функций: Сгур®Асаа1геСопеехе (получение дескриптора для доступа к опре- 
деленным криптоалгоритмам), сгурЕСкеасеНназв (инициализация и получение 
дескриптора хэширования для потоковых данных), СгуреНазЬРака (добавле- 
ние данных пользователя к объекту хэширования), сгурЕБег4уеКеу (генера- 
ция криптографического ключа на основе данных объекта хэширования), 
Сгур®Безегоуназв (освобождение дескриптора хэширования), СкуреЕпскуре 
(шифрование данных по указанному алгоритму и ключу), сгурЕБезегоуКеу 
(освобождение дескриптора ключа), сгурЕВе1еазеСопеехе (освобождение де- 
скриптора доступа), скурЕБескур® (дешифровка данных по указанному алго- 
ритму и ключу), СгуребепКеу (генерация случайного криптографического 
ключа), СгурЕбекОзегКеу (Получение дескриптора для пользовательского 
ключа), СхуркЕхрогЕКеу (экспорт криптографического ключа или пары клю- 
чей для алгоритма шифрования) и СгурЕарог(Кеу (передача криптографиче- 
ского ключа объекту доступа). 


И в завершение темы изучите пример работы с классом скуркоЕзле в Лис- 
тинге 20.26. 


Листинг 20.26. Использование класса СгуреоЕ11е в программе 


// подключаем файл определений класса 

{1ос1аае "гурбоР11е.в" 

// создаем объект класса 

СгуркоЕ11е скуре; 

// определяем пароль для шифрования файла 

сраг* раз$ = "тмусгурес1а$$"; 

// выполняем шифровку файла с заданным паролем 

стурЕ.ЕпсгурЕ ( "С:\\Мубесгеф.аос", "С:\\МуЗесгее.Ааез", разз, ЁЕа15е); 
// выполняем дешифровку файла с заданным паролем 

сгуре.Бескуре ( "С: \\МуЗесгеф.а4ез", "С:\\МуЗесгее. ос", разз, Ёа1зе); 
// выполняем шифровку файла в режиме автоматической генерации пароля 
скур®.Епсгур® ( "С: \\Му$естее.дос", "С:\\Мубестее.4ез", МОШЬ, &гае); 
// выполняем дешифровку файла в режиме автоматической генерации пароля 
сгур®.Бесгуре ( "С:\\Му5есгеф.аез", "С:\\МуЗескее.Чос", МОШ., &тае); 
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По умолчанию для шифрования файлов используется алгоритм РЕЗ, но вы 
можете самостоятельно выбрать КС2 (сорЕс_вс2) или ВС4 (сорЕс вс4), вы- 
брав соответствующую константу и заменив ее в коде класса. Я же, в свою 
очередь, хочу на этом завершить вопросы программирования файловой сис- 
темы в \т4о\$ и надеюсь, что рассмотренный материал поможет вам не 
только в повседневной работе, но и в дальнейшем изучении поистине без- 
граничных глубин интерфейса \\!!132 АР. 


ГЛАВА 21 


Работа с Интернетом 


Думаю, не стоит говорить, какое значение имеет глобальная сеть в совре- 
менной жизни. Трудно представить современную динамически развиваю- 
щуюся организацию без компьютерной техники ‘и средств доступа в Ин- 
тернет. Непременным условием стабильной работы является организация 
собственных ресурсов в сети для рекламирования услуг, а также для предос- 
тавления обновленной информации потенциальным и реальным пользова- 
телям о производимой продукции. Все это требует не только желания, но и 
соответствующего программного обеспечения. Именно по этой причине 
сегодняшнему разработчику так необходимо иметь представление о сетевых 
протоколах и интерфейсах, позволяющих создавать современные коммерче- 
ские программные продукты. Несмотря на разнообразие всевозможных 
скриптовых языков, все базовые компоненты пишутся исключительно на 
С/С++. В этой главе мы поговорим о некоторых важных вопросах про- 
граммирования, связанных со Всемирной паутиной. Мне бы хотелось выде- 
лить несколько базовых тем, которые будут рассмотрены далее: 


1. Создание соединения для доступа в сеть. 
2. Просмотр интернет-ресурсов или организация собственного браузера. 
3. Загрузка файлов. 


21.1. Создание нового соединения 


Как известно, прежде чем войти в сеть с помошью модема (или другого 
устройства), требуется создать специальное соединение. В УМп4о\$ оно 
представляет собой файловый объект, имешфщий определенный формат и 
свойства. Двойной щелчок на таком объекте загружает необходимые биб- 
лиотеки и ресурсы системы, позволяя установить удаленное модемное со- 
единение с сервером провайдера интернет-услуг и через него выйти в гло- 
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бальную сеть. Можно, конечно, воспользоваться специальным мастером 
создания соединения, но мы пойдем более "сложным" путем и выполним 
эту задачу программно. 


Чтобы получить новое соединение для удаленного доступа, нужно приме- 
нить программный интерфейс КАЗ$ (Кетое Ассез$ Зегусе — служба удален- 
ного доступа). Все необходимое находится в системной библиотеке Казар132.а1, 
поэтому мы создадим класс, динамически загружающий данный модуль, а 
затем получим указатели на необходимые нам функции. Пример реализации 
такого класса показан в листингах 21.1 и 21.2. 


// подключаем необходимый файл определений 
#1пс1аае <газ.В> 
// объявляем указатели на используемые библиотечные функции 
// указатель на функцию ВазЕпииОеу1сез 
фуредеЕ ОМОВО ( САБЪВАСК* рЕпВАЗЕМОМОЕУТСЕ$) ( .РВАЗРЕУТМЕО 1рреу1ТпЕо, 
ТРОМОКО 1рсЬ, ЪРОМОВО 1рспеу1сез); 
// указатель на функцию Ваз\а11ЧахеЕпегуМаще 
фуреаеЕ РИОВО ( САШВАСК* рЕпВАЗУАТТРАТЕЕМТВУМАМЕ) ( .РСТЗТВ 1р52Воок, 
ТРСТЗТВ 1рз2Еп®гу); 
// указатель на функцию КазбесЕпегуРгорехг® 1ез 
фуредеЕ ОМОВО ( САШВАСК* рЕПВАЗЗЕТЕМТВУРКОРЕВТТЕ$) ( ТРСТЗТВ 1рз2Воок, 
ТРСТЗТВ 1рэз2Епеку, ТРВАЗЕМТВУ 1рВазЕпеку, ОМОВЬ ЧмЕпегу1ТоЕо512е, 
ТРВУТЕ 1рюреу1се1тпЕо, РИОВО: Чиреу1се1птЕо$12е); 
// указатель на функцию Казбе Епегур1а1Рагатз 
фуредеЕ ОМОВО ( САБВАСК* рЕпКАЗЗЕТЕМТВУОТАЬРАВАМ$ ) ( ТРСТЗТВ 1рз2Воок, 
ТРВАЗОТАГРАВАМ$ 1ргазЯ1а1рагамз, ВООЪ ЕВепоуеРаззмога); 
// объявляем наш класс 
с1а55$ Соппесе 


{ 


ра611с: 
Соппесе (); // конструктор 
-Соппесе (); // деструктор 


// общие функции 

// перечисление доступных устройств 

роо1 Епипреу1сез ( НИМР ЮСопфоВох); 

// функция для создания нового соединения 

Роо1 Схеа®еСоппес® ( соп5® сВаг* Чеу1се, соп5® сраг* папе, 

соп5& сваг* рпопе_пиопфетг, соп5® сваг* \а5ехг, сопз® сВаг* раззмога); 

рг1уафе: 

НТМ5ЗТАМСЕ ВВазЪ1ргакгу; // дескриптор системной библиотеки Казар132.911 


Глава 21. Работа с Интернетом 735 


// закрытые функции 
// перечисление доступных совместимых устройств 
ОИОКР _ВазЕпиреу1сез ( ЪРКАЗОЕУТМЕО 1рБазБеуТпЕо, ЪРОМОВО 1рсь, 
ТРОМОВО 1рсреу1сез5); 
// проверка правильности формата имени соединения 
ОИОВО _ВазУа11ЧасеЕпекумаме ( ЪРСТУТВ 1рз=Рпопероск, 
ТРСТУТВ 1р52Епёку); 
// создание и модификация новой записи в телефонной книге 
РИОВОЬ _ВазбеЕпекуРхорех®1ез ( .РСТЗТВ 1рз2Рпопероок, 
ТРСТУТВ 1р52Епёгу, ГРВАЗЕМТВУ 1рвазЕпеку, ОМОВО амЕпегуТпЕоб12те, 
ТРВУТЕ 1ррбеу1сеТптЁо, ОИОВО 9мреу1се1пЕо51те); 
// редактирование информации о текущем соединении 
РИОВО _Ваз5еЕпеху01а1Рагатз ( ТГРСТ$ТВ 1рз2Рпопероск, 
ТРВАЗОТАТРАВАМ$ 1рга591а1рагатз, ВООЬ ЕВетоуерРа$5мога); 
}; // окончание класса 





// подключаем необходимые файлы 
#1ос1аде "зЕдаЕх.в" 
#1пс1а4е "Соппес®.В" 
// реализация класса Соппесе 
Соппесе :: Соппесе () 
{ 
// обнуляем переменные 
ЮВаз41ргаку = МО; 
// загружаем системную библиотеку 
ЮВаз1ргагу = ГоаЯЬ1ргагу ( ТЕХТ ( "газар132.911")); 
// если библиотека не загружена, выходим 
1Е ( 'ЮВаз1ТАфгагу) гебагп; 
} 
Соппес® :; -Соппес® () 
{ 
// выгружаем системную библиотеку 
1Е ( ПВазЫЁргагу) Егее!]ргаку ( ПВаз11Ьгагу); 
} 
ОИОКР Соппесе : :_ВазЕпитОеу1сез ( ТРВАЗОЕУТМЕО 1рКазбеуТпРо, 
ТРОМОВО 1рсЮ, ГРОМОВО 1рсреу1сез) 


РЕПВАЗЕМОМОЕУТСЕ$ геза1%; 

// получаем указатель на функцию 

хе5111Е = ( рЕПВАЗЕМОМОЕУТСЕ$) СеергосАаЯгезз ( НВаз1ргаку, 
"ВазЕпипреу1сез"); 
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// если не удалось получить указатель, выходим с ошибкой 
1Е ( !геза16) хебагп 1; 
// иначе возвращаем указатель на функцию ВазЕпиа)еу1сез 
гебагп ( *гезо1е) ( 1рВазбеуТпЕо, 1рсф, 1рсбе\у1сез); 
} 
ОИОВР Соппес® : : КазУа11ЧдатеепегуМаме ( ТРСТЗТВ 1р52Рпопероок, 
ТРСТ5ТВ 1рз2Епеку) 


РЕПВАЗУАТТРАТЕЕМТВУМАМЕ гез\1%; 
// получаем указатель на функцию 
геза1Е = ( рЕПКАЗУАЬТРАТЕЕМТВУМАМЕ) СесРгосАаагез5 ( ПВазргахгу, 
"ВазУа11АахеЕпекуМаме"); 
// если не удалось получить указатель, выходим с ошибкой 
1Е ( !гезо1е) гхебагп 1; 
// иначе возвращаем указатель на функцию КазУ\а11ЧафеЕпегуМате 
гееауп ( *гез\а16) ( 1р52Рпопероок, 1р52Епеку); 
} 
ОМОВО СоппесЕ :: _ВазбеЕп®гуРгорег&1ез ( ЬРСТЗТВ 1рз2Рпопероок, 
ТРСТЗТВ 1рз2Епеку, ТРВАЗЕМТВУ 1рКазЕпехгу, ОМОВО амЕпекуТпЕо512е, 
ТРВУТЕ 1рьбеу1сетрёо, БМОЕВО амреу1ТпЁо512е) 


РЕПВАЗЗЕТЕМТВУРКОРЕВТТЕ$ ге5\11<; 

// получаем указатель на функцию 

ге5\116 = ( рЕПВАЗЗЕТЕМТВУРКОРЕВТТЕ$) СееРгосАаагезз ( ПВаз11ргагу, 
"ВаззесЕпегуРгорег®1е5"); 

// если не удалось получить указатель, выходим с ошибкой 


1Е ( !гезо16) гебокп 1; 
// иначе возвращаем указатель на функцию ВазбекЕпегуРкорегЕ1ез 
тебатп ( *гез\16) ( 1рз2Рропероок, 1рз2ЕпЕку, 1рКазЕпёгу, 


@ЧиЕпеху1ТпЕо51хе, 1рЬбеу1се!рЕо, @мреуТпЁо517те); 
} 


РИОВР Соппесе :: _КазбеЕпекуО1а1Рагамз ( ЪРСТЗТВ 1рз2Рпопероок, 
ТРВАЗОТАТРАВАМ$ 1ргаза1а1ракатз, ВООЬ ЕВетоуерРа$5мога) 


РЕПВАЗЗЕТЕМТВУОТАГРАВАМ$ ге5\а1{; 

// получаем указатель на функцию 

геза1& = ( рЕПВАЗЗЕТЕМТВУОТАТРАВАМ$) СесРгосАЯагезз ( ВКазЬ1ргаку, 

"ВазбеЕЕпегу01а1РагатзА"); 

// если не удалось получить указатель, выходим с ошибкой 

1Е (!геза1е) гебахгп 0; 

// иначе возвращаем указатель на функцию Вазбе Е пе гуП1а1Рагат5 

гебагп ( *геза16) ( 1рэз2Рропероок, 1ргазЧ1а1рагатз, 
ЕВепоуеРа$змога); 
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роо1 Соппес®е :: Епит)еу1сез ( НИМО НСопоВох) 
{ 
ОМОВО ОмВоЕЁЁЕег$12е = 0, ЧмМим = 0; // размер буфера и число структур 
ВАЗОЕУТМЕО* рТоЕо = МОШ; // указатель на информационную структуру 
// определяем необходимый размер буфера для структур ВАЗБВЕУТМЕО 
_ВазЕпопреу1сез ( МОШ, &9мВаЕЁег$12е, &амМом); 
// выделяем необходимую память из кучи и инициализируем нулями 
р!ТпЕо = ( ТРВАЗОЕУТМЕО) С1ора1А11ос ( СРТВ, амВаЕЕет51те); 
// если память не выделена, выходим из функции 
1Е ( ршЕо == МОБЬ) гебагп Еа15$е; 
// определяем размер структуры 
рТаЕо->9м$512е = з1хеоЕ ( ВАЗОЕУТМЕО); 
// перечисляем совместимые с ВАЗ устройства 
1Е ( ВазЕпимОеу1сез ( рТпЕо, &амВаЕЕег51те, &ЧмМим)) 
гератп Еа15е; // выходим, если произошла ошибка 
// добавляем имена найденных устройств в комбинированный список 
Бог ( ОМОВО 1 = 0; 1 < 9мМам; 1++) 
{ 
ЗепМеззаде ( ПСопфоВох, СВ _АООЗТВТМС, 0, 
( .РАВАМ) ( ТРСТЗТВ) р1тЕо->52Оеу1семапе); 
// переходим к следующему устройству 
рТпЕо++; 
} 
// освобождаем память 
С1ора1Егее ( р1ТпЕо); 
// выходим из функции 
гесогп &тце; 
} 
роо1 СоппесЕ :: СгеакеСоппесе ( сопз® срах* аеу1се, сопзЕ спаг* папе, 
сопзЕ сНаг* рпопе полет, сопзЕ сНак* изех, сопзЕ спаг* раз5мока) 


ВАЗЕМТВУ газ; // описание записи в телефонной книге 

// обнуляем структуру 

?егоМетогу ( &газ, $12еоЕ ( КАЗЕМТВХ)); 

// проверяем правильность формата имени соединения 

1Е ( _ВазУа11ЗасеЕпехгуМате ( МОШ., папе) != ЕАКОВ_$0ССЕ$5) 
гебаго Еа1зе; // выходим из функции, если ошибка 

// заполняем требуемые поля структуры ВАЗЕМТВУ 

газ.0м512е = 5з12ео0Е ( ВАЗЕМТВУ); // размер структуры 

// стандартный путь для ТР-пакетов 

газ .ЧмЕОр®1оп$ = ВАЗЕО ВешокеПеЁЕал1«Сафемау; 

газ .ЗмЕМеЕРго*осо1$ = ВАЗМР Тр; // сетевой протокол ТСР/ТР 

газ.ЯиЕкаи1паРгоеосо1 = ВАЗЕР_Ррр; // тип удаленного доступа РРР 
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зЕгсру ( газ.57АкеаСоде, " "); // код города 
зЕгсру ( газ.з;Ьоса1Рнопемонюег, рпопе попфег); // номер телефона 
// полный путь к библиотеке (файл О) автодозвонки 
$Егсру ( газ.32АйакоЧ1а1011, " "); 
5&гсру ( газ. 5?Апбоа1а1Рапс, " "); // имя функции автодозвонки 
ЗЕгсру ( газ.з7Оеу1сеТуре, ВАЗОТ Модет); // тип устройства 
зЕгсру ( газ.520еу1семаще, Чеу1се); // имя устройства 
// добавляем новую запись в телефонную книгу 
1Е ( ВазбесЕпекуРгорег®1ез ( МОШ., паще, &газ, 512еоЁ ( КАЗЕМТВУ), 
м, м9) ) 
геёигп Еа15е; //выходим из функции, если ошибка 
// определяем настройки для удаленного соединения 
ВАЗОТАЬРАВАМ а1а1; 
// заполняем поля структуры КАЗОТАГРАВАМ 
Я1а1.ам5Ахе = 5з1хеоЁ ( ВАЗОТАТРАВАМ$); // размер структуры 
$Егсру ( Ч1а1.52Еп 6 гуМаце, папе); // имя соединения 
зЕхсру (91а1.з2Рропемлирег, " "); // телефонный номер 
// телефонный номер обратного вызова 
5Егсру ( Я91а1.32Са11раскМаирег, " "); 
зе ксру ( 91а1.з2ОзеуМаме, изег); // имя пользователя 
зЕгсру ( 91а1.з2Раззмог, раззмога); // пароль пользователя 
// сохраняем настройки для удаленного соединения 
1Е ( _ВазбеЕпеку01а1Рагамз ( МО, &91а1, Еа1зе)) 
геботп Еа15е; // выходим из функции, если ошибка 
// выходим из функции 
тесагп Етое; 


Созданный класс Соппесе содержит всего две открытые функции, одна из 
которых перечисляет доступные устройства, а другая создает новое соеди- 
нение на основе введенных пользователем данных. Для реализации задачи 
мы задействовали всего четыре библиотечных функции: вазЕпимбеу1сез (пе- 
речисление устройств), вазУа11дахеЕрегуМаме (проверка формата введенного 
пользователем имени соединения), ВазбеъЕпекуРгорег%1ез (добавление запи- 
си в телефонную книгу) и ВазбеЕЕпегур1а1Рагащз (настройка параметров 
удаленного соединения). Кроме функций были использованы специаль- 
ные структуры: вАЗБЕУТМЕО (информация об устройстве ТАР1, совместимом с 
КА$), ВАЗЕМТВУ (описание формата записи в телефонной книге) и 
ВАЗРОТАЬРАВАМ$ (описание параметров для настройки удаленного соединения). 


Перед применением класса Соплесе в своей программе подготовьте в редак- 
торе ресурсов пользовательский интерфейс: средства ввода данных и кнопку 
создания соединения. Добавьте раскрывающийся список, если необходимо 
предоставить пользователю возможность выбора устройства связи. После 
этого вызовите класс Соппеск, как показано в листинге 21.3. 
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Листинг 21.3. Использование класса Соппес® 





Нос1оаае "Соппесеё.В" 

// примерный код работы с классом Соппес® 

Соппес® МемСоппес®; // объявляем класс 

СВаг Чеу1се[150] = " "; // переменная для хранения имени устройства связи 

// получаем дескриптор комбинированного списка 

НИМО ЮСопфоВох = бефро191ем ( №019, ТОС МУСОМВО)}; 

// перечисляем доступные устройства и добавляем их в список 

МемСоппес®* .ЕпиОеу1сез ( ВСопроВох); 

// устанавливаем первое найденное устройство по умолчанию 

ЗепЯМеззаде ( ПСопроВох, СВ_ЗЕТСОВЗЕТ, 0, 0); 

// получаем номер и имя выбранного в списке устройства 

106 зе1 = ЗепаМеззаде ( ПСопфоВох, СВ_СЕТСОВЗЕТ, ( МОВО)0, 01); 

ЗепЧМез5аде ( ПСопроВох, СВ СЕТЬВТЕХТ, ( МОВО) 5е1, ( ОМС) аеу1се); 

// создаем новое соединение по умолчанию 

МемСоппес® .Сгеа®еСоппес® ( Чеу1се, "Тез Соппес®1оп", "123456", "МуМапе", 
"МуРаззиога"); 


Как видите, создать новое соединение очень просто. Если вам понадобится 
более тонкая настройка параметров соединения, самостоятельно изучите 
документацию на представленные в классе Соппесе библиотечные функции 


и структуры. 


21.2. Просмотр сетевых ресурсов 


Всем хорошо известны наиболее популярные программы для просмотра ин- 
тернет-страниц: Пиеге Ехрюгег, Мебсаре Мауюаюг, Орега. Основной 
принцип работы этих браузеров заключается в отображении сетевых ресур- 
сов на экране пользователя и удобной системе навигации. Дополнительно 
каждое из перечисленных приложений предоставляет целый ряд сервисных 
услуг для настройки удобного интерфейса, защиты и языковых кодировок. 


Мы попытаемся написать собственный простейший браузер под \Утао\$, 
который будет выполнять только самые необходимые функции. Для реше- 
ния поставленной задачи существует несколько базовых методов: библиоте- 
ка МЕС (класс снет1\У1ем), библиотека активных шаблонов АТЁЬ и \т32- 
АРТ. Первый способ прост в реализации, но автоматически "цепляет" за со- 
бой множество файлов. Второй способ очень элегантен и красив, но не от- 
носится к теме книги, поэтому мы будем решать задачу с помощью самого 
сложного (на первый взгляд) варианта и применим всю мощь интерфейса 
\п32 АР]. 


Уважаемый читатель знает, что наряду с огромным набором функций \\п32 
АРТ содержит не один десяток интерфейсов, определяющих основные функ- 
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циональные возможности оболочки У/т4о\з. Для тех, кто не знаком с по- 
нятием интерфейса, поясню, что он представляет собой абстрактную обо- 
лочку, включающую в себя набор методов и свойств, организующих реше- 
ние конкретной задачи. Имена всех интерфейсов начинаются с латинской 
буквы '', чтобы их можно было легко отличить от классов. И это важно 
помнить и понимать, поскольку интерфейс и класс — абсолютно разные 
понятия. Класс содержит в себе как определение, так и обязательную реа- 
лизацию всех объявленных функций (здесь не идет речь об абстрактных 
классах и виртуальных функциях). Интерфейс всегда содержит определение 
методов (те же функции), но никогда их реализацию. Он служит в качестве 
обертки для реальных объектов. Все существующие и любые новые интер- 
фейсы являются расширениями базового интерфейса топкпомт. Он имеет 
всего три метода (ОзехгуТпеекРасе, АЧаВеЕ И Ве1еазе), Которые обязательно 
добавляются к набору методов производного интерфейса. Нас в первую 
очередь будет интересовать метод ОбзехгутпеехЕасе, позволяющий получить 
указатель на требуемый интерфейс. Важно понимать, что интерфейс нельзя 
объявить как класс, поскольку он, в принципе, не существует (абстрактен), 
поэтому всегда используется только указатель на этот интерфейс. При на- 
личии реально существующего в системе объекта метод Оцехгути$егЕасе воЗ- 
вратит указатель на него. Кроме того, программист должен написать реали- 
зацию всех методов как непосредственно используемого интерфейса, так и 
базовых (обычно это методы интерфейса топкпомт). Понятно, что многие 
определяемые методы не нужны, поэтому для них пишутся "заглушки". Как 
все это делается, вы увидите далыше. В любом случае, если вы ранее не 
сталкивались с понятием интерфейса, объектной модели СОМ и технологии 
ОТЕ, имеет смысл почитать соответствующую литературу, например [5]. 


А теперь перейдем непосредственно к решению поставленной задачи. Нам 
понадобится написать реализацию для следующих интерфейсов: т5еогаде 
(поддержка объектов в памяти), т01ес11епе51ее (отображение информации и 
интерфейса на экране), то1етпР1асе51“е (управление связью между объектом 
и контейнером), то1етпР1асеггаще (управление окном верхнего уровня) и 
ТРосНозОТНап1ег (обработка меню и панелей инструментов). 


Прежде всего, создайте новый пустой проект типа \т32 АррИсайоп и назо- 
вите его, например, У е5Вгомзег. Для реализации каждого перечисленного 
интерфейса понадобятся отдельные заголовочные файлы: [Зюгазе.Н (лис- 
тинг 21.4), ТОеСИетие.В (листинг 21.5), О1е!пР!асезие.В (листинг 21.6), 
1ОештР!асеРгате.й (листинг 21.7) и [ДосНозЛНап4ег.в (листинг 21.8). 





Листинг 21.4. Реализация интерфейса т5+огаде 


// список методов интерфейса Т5®огаде 
НВЕЗОЬТ ЗТОМЕТНОБСАЬБЬТУРЕ 5%ог_ОцегуТп%етЕасе ( Т5®огаде ГАК* 5®ог, 
ВЕЕТТО х11а, .РУОТРЬ ЕАВК* рру0р)); 
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НВЕЗОПГТ ЗТОМЕТНОБСАГГТУРЕ 5$$ог АааВеЕ ( Т15®огаде ЕАВ* 5%ог); 

НВЕЗОЬТ ЗТОМЕТНООСАБЬТУРЕ 5$ог Ве1еазе ( 15хогаде КАВ* ТЮ15); 

НВЕЗОТТ ЗТОМЕТНОБСАЪЬТУРЕ 5$ог Сгеабеб®геам { Т5когаде ЕАВ* $%ог, 
соп5е ИСНАВ* русзМаме, ПМОВР дхЕМоае, ПМОЕР гезегуеЯ1, ПМОВР гезегуеа2, 
Т5Егеаш** ррэет); 

НВЕЗОТТ ЗТОМЕТНОБСАЪЬТУРЕ 5%ог_ОрепбЕгеам ( Т5%огаде ЕАВ* 5%ог, 
соп5* ИСНАВ* русзМаме, уо14а* гезегуеЯ1, ОМОВРЬ дхЕМоде, ПМОВР гезегуеа2, 
15егеам** ррэ®м); 

НВЕЗОТТ ЗТОМЕТНОБСАЪЬТУРЕ 5%ог СгеафебХогаде (Т5еогаде ЕКАВ* 5%ог, 
соп$& ИСНАВ *рис5Маме, ПМОВР дхЕМоае, ОМОВР гезегуеЯ1, ПМОВО гезетгуе92, 
Т5фогаае **рр5еа); 

НВЕЗОГТ 5ТОМЕТНОРСАТТТУРЕ $$ог Ореп5Еогаде ( Т5®огаде РГАВ* 5%ог, 
соп$Е МСНАВ* рисзМаще, Т5фогаде* рэеаРу1от1еу, ОМОВР дтгЁМоае, 

ЗМВ эпБЕхсТаае, ОМОВО гезегуеа, Т5еогаде** рр5%а); 

НВЕЗОТТ ЗТОМЕТНООСАЪЬТУРЕ $%ог_СоруТо ( 15еогаде ЕАВ* 56ог, 
ОИОВО с11аЕхсаае, ТТО соп5®* хд11АЕхсаае, МВ эпЪЕхс1аде, 
15$огаде* рзЕа0ез®); 

НВЕЗОПТ ЗТОМЕТНООСАТТТУРЕ 5Еох МоуеЕ1ещепЕеТо ( Т5&огаде КАВ* 5%охг, 
соп5$Е ОШЕСНАВ* рисзМапе, Т5®огаде* рзеч0ез®, сопз® ОТЕСНАВ* рисзМемМапе, 
ОМОВО чхЕЁЁЕ1ач$); 

НВЕЗОЬТ ЭТОМЕТНОРСАЬИТУРЕ 5%ох Сопи1 (15огаде РАВ* 5%ог, 

ОМОВО чкЕСопи1Е1а95); 

НВЕЗОТТ ЗТОМЕТНОБСАЪЬТУРЕ 5®ог_Веуег® ( Т156огаде ЕАВ* 5%ог); 

НВЕЗОПГТ ЗТОМЕТНОБСАТЬТУРЕ $%ох_ЕпумЕ1етепез ( Т5фокаде ЕАВ* 5$ог, 
ОМОВО гезегуеЯ1, уо1а* гезегуеа?, ОМОВО гезегуеаЗ, 

ТЕПОМЗТАТ$ТС** ррепам); 

НВЕЗОЬТ ЗТОМЕТНОРСАШЬТУРЕ $$ог БезкгоуЕ1етепе ( Т5фогаде ЕАВ* 5%ог, 
соп5Е ОБЕСНАВ* рисзМапе); 

НВЕЗОТТ ЗТОМЕТНОБСАЬЬТУРЕ 5%ог ВепапеЕ1етепе ( 15$огаде ЕАВ* 5%ог, 
сопз& ИСНАВ* рисз01ЧМаме, сопзЕ ИСНАВ* рисзМемМапе); 

НВАЕЗОГТ ЭТОМЕТНОРСАЬИТУРЕ 56ог_5е Е1елепЕТиез$ ( Т5согаде ЕАВ* 5%ог, 
сопзЕ ИСНАВх рисзМаме, ЕТЬЕТТМЕ соп5®* рсЕ\ме, ЕТЬЪЕТТМЕ соп5®* раб те, 
ЕТТЕТТМЕ соп$** рабше); 

НВЕЗОПГТ ЗТОМЕТНООСАТЬТУРЕ $%ог 5ееС1аз5 ( Т5фогаде ЕАВ* 5%ог, 

ВЕЕСЬЗТО с1$19); 

НВЕЗОБТ ЗТОМЕТНОРСАЦЬТУРЕ 5$ок_ Зе е5фафеВ1$ ( Т5%огаде ЕАВ* ТЬ15$, 
РИОВР дгЕЗафеВ1*5$, ОМОВО дхЕМазКк); 

НВЕЗОТГТ ЗТОМЕТНООСАГЬТУРЕ 5+о0г_5%ае ( Т5®огаде ЕАВ* 5%ог, 
ЭТАТЗТС* рзбаё$69, ОМОВО дхЕ5фаеЕ1ач); 

// определяем порядок методов для виртуальной таблицы Т5®огаде 

Т5богаде\ЕР1 Т5еогадеМефоаз = 

{ 

Зкох’ Оцехутп(егЕасе, 5%ог АааВеЕ, 5%ог Ве1еазе, 5Еог Стеафебетгеам, 
Зеог Ореп5&геаш, 5®ог Стеаке5®огаде, З®ог_ОрепЗ®еогаде, 5ЗЕок_СоруТо, 
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Зеог МоуеЕ1етепеТо, 5Еог_Сошт1®, 5%ог_Веуег®, 5%ог ЕпомЕ1ещепф$, 
Зфог ПезсгоуЕ1етепо, ЗЕог ВепамеЕ1етепе, ЗЕох_бееЕ1етепеТ\мез, 
ЗЕог 5еёС1азз, 5%ог беё5®аеВ1®5, 5%ог За 

}; 

// определяем объект для инициализации 15%огаде 

Т5%огаде _Т5фогаде = { &15%огадеметоаз }; 

// пишем реализацию методов интерфейса 

// для неиспользуемых методов ставим "заглушки" в виде Е_ МОТТМРЬ 

НВЕЗОТГТ ЗТОМЕТНОРСАТЬТУРЕ 5%ог_ОпегуТпфегЕасе ( Т5хогаде` ЕАВ* Зфог, 
ВЕЕТТО г11а, ГРУОТО ЕАВ* рруОЮз) 

{ 

хебигп Е МОТ1МР1; // не используется 

} 

НВЕЗОТГТ $ТЬМЕТНОРСАЬГТУРЕ 5®охг_АааВеЕ ( Т5&огаде ЕАВ* ЗЕог) 

{ 

гесакп 1; 

} 

НВЕЗОТТ 5ТОМЕТНОРСАШГТУРЕ 5%ог Ве1еазе { Т5®огаде ГАВ* 5®ог) 

{ 

гевигп 1; 

} 

НВЕЗОГТ ЗТОМЕТНОРСАЪЬТУРЕ 5®ог_Стеа®е$геам ( Т5®огаде ЕГАВ* 5Ъог, 
соп$® ИСНАВ* рисзМаме, ОИОВР дгЕМо4е, РМОВО гезегуеЯ1, ОМОВО гезегуеа2, 
15Егеаш** ррэбм) 

{ 

тебагп Е МОТТМРЬ; 

} 

НВЕЗОГТ ЗТОМЕТНОБСАТУРЕ 5$ог _Ореп5&геам ( Т5$огаде ЕАВ* 5®ог, 
соп3Е ИСНАВ* рисзМаще, у014* гезехгуеЯ1, ОПМОКР дхЕМо4е, ПИОВО гкезекуеа2, 
Т5Егеам** ррэ@м) 

{ 

гебиги Е_МОТТМРЬ; 

} 

НВЕЗОГТ ЗТОМЕТНООСАЬИТУРЕ 5%ог Схеафеб®огаде ( 15когаде ЕАВ* 56ог, 
соп5Е ИСНАВ* рисзМате, ОМОВО дкЕМоде, ОМОВО гезегуеЧ1, ПМОВР гезегуед2, 
Т5фогазе** ррз®а) 

{ 

хебсиги Е МОТТМРЬ; 

} 

НВЕЗОГТ ЗТОМЕТНООСАБЬТУРЕ 5%ог _Орепбфогаде ( Т5еогаде ГАВ* 5®ог, 
сопз* ИСНАВ* рисзМаме, Т5®огаде* р5®аРх1отг1у, ОИОВО дхЕМоае, 

ЗМВ зпБЕхс1а4е, ПМОВО гезегуеа, Т5%огаде** ррэ®а) 
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тебагп Е_МОТТМРЬ; 

} 

НВЕЗОЬТ ЗТОМЕТНОРСАШТУРЕ $6ог СоруТо ( Т5®окаде ЕАВ* $$ог, 
ОИОВО .с11ЧЕхс1а4е, ТТО соп$е* го11аАЕхсаЧе, УМВ зорЕхс1аае, 
Тофогаде* рз&90езе) 

( 

хебогп Е_М№ТТМРГ; 


} 
НАЕЗОГТ ЗТОМЕТНООСАЪЬТУРЕ 5%ог МоуеЕ1етепеТо ( 15хогаде ЕГАВ* 5%ог, 
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соп5Е ОЪЕСНАВ* рисзМаме, Т5®огаде* р5%д30ез®, соп5$® ОБЕСНАВ* рис5МемМапе, 


ОМОВОР дуЕЕ1ад$) 
{ 
теёагп Е _М№Т1МРГ; 

) 

НВЕЗОЬТ ЗТОМЕТНОБСАЪЬТУРЕ 5%ог Соги1е ( Т56огаде РАВ* 5%ок, 
ОМОВО чхЕСопич ®Е1ад5$) 

{ 

тебаги Е МОТТМРЬ; 

} 

НВЕЗОТТ ЭТОМЕТНОБСАТЬТУРЕ 5$ог Веуете ( Т56огаде ЕАВ* 5%ог) 

{ 

хебатй Е МОТ1МРЦ; 

) 

НВЕЗОЬТ ЗТОМЕТНОБСАЬЬТУРЕ 5%охг_ЕпамЕ1етепе$ (Т5®огаде РАК* 5%ог, 
ОМОВО гезегуеа1, уо1а* тезегуеа?, ОМОВО гезегуеа3З, 
ТЕПОм5ТАТ$ТС** ррепим) 

4 

тебатп Е МОТ1МРЬ; 

} 

НВЕЗОЬТ $ЗТОМЕТНОБСАТТУРЕ 5$охг_Оез&гоуЕ1ещепе ( Т5фогаде КАВ* 5%ог, 
сопзЕ ОБЕСНАВ* рисзМапе) 

{ 

хебакп Е_МОТ1МРЬ; 

} 

НВЕЗОТТ ЗТОМЕТНООСАГЬТУРЕ 5$ог ВепапеЕ1етепе ( Т5%огаде КАВ* 5%ог, 
соп5Е ИСНАВ* рис501ЯМаще, сопзе ИСНАВ* рисзМеуМаме) 

{ 

хебаги Е МОТТМРГ; 


} 
НВЕЗОЬТ ЗТОМЕТНООСАШТУРЕ 5%ог_беЕ1емепеТ1тез ( Т5$огаде ЕАВ* 5$ог, 


сопзЕ ИСНАВ* рисзМаше, ЕТЬЕТТМЕ соп$®* рсе\ие, ЕТЬЕТТМЕ соп5е* раб1те, 


ЕТЬЕТТМЕ соп5®* риблте) 
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гебагп Е МОТТМРГ; 
} 
НВЕЗОГТ ЗТОМЕТНОРСАГГТУРЕ 5$ох_5ееС1аз5 (15$огаде ЕГАВ* ТИ13, 
ВЕЕСЬЗТР ©1514) 
{ 
гебагп 5_ОК; 
} 
НВЕЗОГТ ЗТОМЕТНОРСАТГТУРЕ 5+охг_бек5каееВ1е5 ( Т5$когаде ЕАВ* 5%ог, 
РИОКР чуЕ5афеВ1е$, ПМОКР чхЕМазКк) 
{ 
тебогп Е_МОТТМРГ; 
} 
НВЕЗОГТ ЗТОМЕТНОРСАТЬТУРЕ 5$ох_5$аф ( Т5еогаде ЕАВ* 5%охг, 
ЗТАТЗТС* ръбаез6а, ОМОВР чхЕЗфа®Е1ача) 
{ 
теёогп Е МОТТМРГ; 


Листинг 21.5. Реализация интерфейса 101еС11епЕ51+е 
// список методов интерфейса 101еС11еп&51%е 
„ НВЕЗОПТ 5ТОМЕТНОРСАЦШОТУРЕ С11епе51{е ОцегуТибегЕасе ( 
101еС11еп516е ЕАВ* С11еп516е, ВЕЕТТО у114, \у01с** рруОБ)ес®); 
НВЕЗОГТ ЗТОМЕТНОРСАШОТУРЕ С11епЕ51{е_ АааВеЕ ( 
101еС11епё516е РАВ* С11епё51%е); 
НВЕЗОГТ ЗТОМЕТНОРСАГГТУРЕ С11епе51%е_Ве1еазе ( 
Т01еС11епё516е КАВ* С11епё5е); 
НВЕЗОГТ ЗТОМЕТНОРСАЦИТУРЕ С11епе51$е_бауеОБлес® ( 
101еС11епе516е ЕРАВ* С11еп51е); 
НВЕЗОГТ ЗТОМЕТНООСАШТУРЕ С11еп51%е_СбеЕМоп1кех ( 
1Т01еС11епе51%е ЕРАВ* С11епё51%6е, ОМОВР 9мАз$з1ап, БИОВО а М1 сПМоп1кег, 
ТМоп1Кех** ррак); 
НВЕЗОГТ $ЗТОМЕТНОРСАТИТУРЕ С11епЕ516е СееСопфа1тег ( 
101еС11епё5$16е ЕАВ* С11еп516е, ТРОТЕСОМТАТМЕВ ЕАВ* ррСопба1тег); 
НВЕЗОГТ ЗТРМЕТНОРСАГИТУРЕ С11еп51{е_5помОБ]есе ( 
101еС11епё516е ЕКАВ* С11епё5е); 
НВЕЗОГТ ЗТОМЕТНОРСАБЬТУРЕ С11еп516е_Опбвоми1таом ( 
101еС11епё516е КАВ* С11епе516е, ВООЬ ЕЗВом); 
НВЕЗОГТ ЗТОМЕТНОРСАШЬТУРЕ С11епе51{е ВедаезМемОЮ)есеГауоце ( 
101еС11епё516е ЕАВ* С11еп*51е); 
// определяем порядок методов для виртуальной таблицы ТО1еС11епё51%е 
101еС11епё516е\Уер1 101еС11епЕ515еМебоа5 = 
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{ 

С11еп5515е ОпегуПицегЕасе, С11ерё$16е_АЯаВеЕ, С11еп$1%6е Ве1еазе, 
С11еп6515е бауеОю)ес®е, С11еп516е СбебМоп1Кег, С11епё5е СееСогка1тег, 
С11еп6516е_ЗпомОБ]есе, С11епЕ516е Оп5помИ1паом, 
С11епЕ51%е `ВеалезМемОЮ)ес&Гауоце 
}; 

// пишем реализацию методов интерфейса 

НВЕЗОЬТ ЗТОМЕТНООСАШГТУРЕ С11епе516е АаавеЕ ( 
1Т01еС11ерё516е ЕАВ* С11епё51е) 

{ 

хебагп 1; 

} 

НВЕЗОБТ ЗТОМЕТНОРСАБГТУРЕ С11ет51{е_Ве1еазе ( 
ТО1есС11ете51%е ЕАВ* С11епё51%е) 

{ 

тебагп 1; 

} 

НВЕЗОЬТ $ЗТОМЕТНОРСАЬЬТУРЕ С11еп51{е_бауеОЮ]есе ( 
ТО1еС11ерпЕ516е ЕАВ* С11епё51%е) 

{ 

теёагп Е МОТ1МРГ; 

} 

НВЕЗОГТ ЗТОМЕТНОРСАБГТУРЕ С11епё51{е СеЕМоп1кег ( 
ТО1ес11епе515е ЕАВ* С11еп651%е, ОМОВО 9мА$$1ап, ОИОКР @мИр1сЬМоп1Кех, 
ТМоп1кКех** ррик) 

{ 

гебагп Е МОТТМРГЬ; 

} 

НВЕЗОГТ ЗТОМЕТНОРСАТШИТУРЕ С11епе516е бесСопба1пег ( 
101еС11еп516е ЕАВ* С11епе516е, ГРОЬБЕСОМТАТМЕВ ЕАВ* ррСопёа1пехг) 
{ 

// контейнер не поддерживается 
*ррСопба1тег = 0; 
хесиагп Е МОТМТЕВЕАСЕ; // указатель не возвращен 

} 

НВЕЗОБЬТ ЗТОМЕТНООСАШГТУРЕ С11епе51%е бромОБдесе ( 
101еС11епё5$1%е ЕАВ* С11еп 5 Це) 

{ 

хебатп МОЕВВОВ; // ошибок нет 

} 

НВЕЗОВТ УТОМЕТНОРСАЬГТУРЕ С11епё51е_ Оп5$ВомИ1 пом ( 
101еС11еп51%е ЕРАВ* С11епё51$е, ВООГ Ё5пом) 

{ 

тебагп Е МОТ1МРГ; 
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НВЕЗОГТ ЗТОМЕТНОРСАЬОТУРЕ С11епё51%е_ ВеалезЕМемОр)есеТауомще ( 
ТО1ес11ерё516е ЕАВ* С11еп51%е) 
{ 
тебагп ЕЁ МОТТМРГ; 


// список методов интерфейса ТО1еТпР1асе51%е 

НВЕЗОЬТ ЗТОМЕТНООСАБИТУРЕ ТпР1асе _ОцегуТпеетЕасе ( 
ТО1еТтР1асе51%е РКАВ* Р]асе, ВЕЕТТО 114, \у0о1а** рруОБ]ес®); 

НВЕЗОБТ ЗТОМЕТНООСАБЫТУРЕ ТпР1асе АдаВеЕ ( 1О1етпР1асе516е ЕАВ* Р1асе); 
НВЕЗОГТ ЗТОМЕТНООСАШИТУРЕ ТпР1асе_Ве1еазе ( ТО1е!ТпР1асе514е ЕАВ* Р1асе); 

НВЕЗОГТ ЗТОМЕТНООСАЬШОТУРЕ ТпР1асе СееиИ1паом ( ТО1етпР1асе$1е ГАВ* Р1асе, 
НИУМР КАВ* 1рЬмута); 

НВЕЗОЬТ ЗТОМЕТНОРСАШИТУРЕ Т1пР1асе_Сопеехе5епз1&1уеНе!?р ( 
101еТтР1асе$16е РАВ* Р1асе, ВООТ, ЕЕпеетМоае); 

НВЕЗОГТ ЗТОМЕТНООСАШИТУРЕ ТпР1асе_СапТпР1асеАс®1хафе ( 
101е1тР1]асе516е ЕАВ* Р]1асе); 

НВЕЗОГТ ЗТОМЕТНООСАГИТУРЕ ТпР1асе _ОпТоР1асеАс®1уа®е ( 
Т01е1тР]асе$16е ЕАВ* Р1асе); 

НВЕЗОГТ ЗТОМЕТНООСАЬТТУРЕ ТоР1асе_ОпОТАс&1уахе ( 

ТО1еТоР1асеб51ее ЕАВ* Р1асе); 

НВЕЗОЬТ ЗТОМЕТНООСАБЬТУРЕ ТпР1асе бееИ1паомСопкех® ( 
ТО1еТпР1асе$16е ЕАВ* Р]асе, ГРОЬЕТМРЬАСЕЕВАМЕ ЕАВ* 1р1рЕгапе, 
ТРОГЕТМРТАСЕОТИТМООЙМ КАВ* ]1р1ррос, ТГРВЕСТ 1ргсРозВеск, 

ТРВЕСТ ]1ргсС11рВес®, ТГРОБЕТМРЬАСЕЕВАМЕТМЕО 1рЕгашеТтЕо); 

НВЕЗОЬТ `ЗТОМЕТНООСАБИТУРЕ ТпР1асе _5сго11 ( ТО1етиР1асе$1е ЕРАВ* Р1асе, 
ЗТАЕ 5сго11Ехбепе); 

НВЕЗОГТ ЗТОМЕТНООСАБИТУРЕ ТпР1асе ОпОТРеас&1уафе ( 

ТО1е1ТтР]асе516е ГАВ*Р1асе, ВОО ЕО0паоаЮ1е); 

НВЕЗОЬТ ЗТОМЕТНООСАЦОТУРЕ ТпР1асе ОпТпР1асебеасе1уафе ( 
ТО1еТпР1асеб1ее ЕАВ* Р1асе); 

НАЕЗОЬТ ЗТОМЕТНООСАШИТУРЕ ТпР1асе О1зсагаОпао$фафе ( 

ТО1етТпР1асе$1$е ЕАВ* Р]асе); 

НАЕЗОЬТ ЗТОМЕТНООСАЬЬТУРЕ ТпР1асе БеасЕ1уафеАпаОпао ( 

ТО1еТоюР1асе51%е КАВ* Р1асе); 

НВЕЗОГТ 5ТОМЕТНОРСАЦШТУРЕ ТпР1асе ОпРозВес®Свапае ( 

ТО1еТпР1асе516е ЕАВ* Р1асе, ЬБРСВЕСТ 1ргсРозВес®); 

// определяем порядок методов для виртуальной таблицы 

ТО1еТпР1асе5 1е\{Ю1 тТО1етпР1асе$1$еМекоа$ = 

{ 


ТоР1асе Оцегу!ТпеегЕасе, ТпР]асе АЧаВеЕ, ТпР1асе_Ве1еазе, 
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ТоР1асе СебИ1таом, ТпР1асе Сопкехе5еп51{1уеНе]р, 
ТпР1асе СапТпР1асеАс&1уафе, ТпР1асе ОпТпР1асеАс&1туаке, 
ТпР1асе ОПОТАС®1уафе, ТпР1асе Се\1оЧомСопеехе, ТпР1асе $сго11, 
Тир1асе_ОпОТОеас®1уа$е, ТпР1асе _ОпТпР1асереас&1чуаке, 
ТпР1асе_01зсагАО0паобеафе, ТпР1асе Оеас®1уафеАпа0рао, 
ТпР]асе_ОпРозВес&Срапде 
}; 
// пишем расширенную структуру 
фуреаеЁ эехас® 
{ 
ТО1еТпР1асе516е Р1асе516е; // наш объект для ТО1етаР1асе$1е 
_ТО1етаР1асеЕхаше Ехаше; // наш объект для ТО1еТаР1асеЁгапе 
} _ТО1етаР1асе$е; 
// пишем реализацию методов интерфейса 
НВЕЗОГТ ЗТОМЕТНОРСАБГТУРЕ ТпР1асе АааВеЕ ( ТО1еТтпР1асе51%е КАВ* Р1асе} 
{ 
хебагп 1; 
} 
НВЕЗОГТ ЗТОМЕТНОРСАБГТУРЕ ТпР]асе Ке1еазе ( ТО1еТпР1асе516е КАВ* Р1асе} 
{ 
хебагр 1; 
} 
НВЕЗОГТ ЗТОМЕТНООСАГЬТУРЕ ТпР1асе бееИ1таом ( 
ТО1еТоюР1асе51е ЕАВ* Р1асе, НИМО ЕАВ* 1рЬмпа) 
{ 
// возвращаем указатель на окно браузера 
*1римтЯ = ( ( _ТО1етиР1асеб1Ее КАВ*) Р1асе) ->Ргате.ВгомзетИ1оаом; 
// выходим 
геогр 5 ОК; 
} 
НВЕЗОГТ ЗТОМЕТНОРСАЦТУРЕ ТпР1асе Сопкех&$епз1%1уеНе]р ( 
ТО] етТпР1асеб16е ЕАК* Р]асе, ВООГ ЕЕпкетМоае) 
{ 
тебикп Е_МОТТМРГ; 
} 
НВЕЗОГТ ЗТОМЕТНОРСАШОТУРЕ ТпР1асе СапТпР1асеАс&1уафе ( 
ТО1еТпР1]асеб1е ЕАВ* Р]асе) 
{ 
// Тет1 Бе Бгомзег ме сап 11 р1асе асе1уафе 
гебигп ($_ОК); 
} 
НВЕЗОГТ ЗТОМЕТНОРСАШОТУРЕ ТпР1асе Оп1пР1асеАс&1уафе ( 
ТО1етТпоР1асе51е ГАК* Р]асе) 
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геогр 5 ОК; 

} 

НВЕЗОГТ ЗТОМЕТНООСАГТУРЕ ТоР1асе ОпОТАСЕ1уафе ( 

ТО1еТтР1асе51%е ЕАВ* Р1асе) 

{ 
гебигп $ ОК; 

} 

НВЕЗОГТ 5ТОМЕТНООСАШГТУРЕ ТпР1асе $сго]11 ( 
Т01е1тР1асе51$е ЕАВ* Р]асе, 5Т2Е зсхо11Ехееп®) 


тебогп Е_МОТТМРГ; 
} 
НВЕЗОЬТ ЭТОМЕТНООСАБИТУРЕ ТпР1асе ОпОТРеас&1уафе ( 
ТО1еТтР1асеб1{е ЕАВ* Р1асе, ВООГ ЕОпаоа1е) 
{ 
гебоагп $_ОК; 
} 
НВЕЗОГТ ЗТОМЕТНОРСАШИТУРЕ ТпоР1асе ОпТпР1асереас®1уафе ( 
ТО1еТрР1асе51%е ЕАВ* Р1асе) 
{ 
гебигп $_ОК; 
} 
НВЕЗОГТ ЗТОМЕТНОРСАЬЬТУРЕ ТпР]1асе _01зсаг@0пао$фаее ( 
ТО1еТпР1асе516е ЕАВ* Р1асе) 
{ 
тебатп Е МОТТМРГ; 
} 
НВЕЗОЬТ ЗТОМЕТНОРСАШТУРЕ ТпР1асе Реас®1уа®еАпа0пао ( 
ТО1еТпР1асе51е ЕАВ* Р1асе) 
{ 
тебагп Е МОТТМРГ; 


Листинг 21.7. Реализация интерфейса тО1еТпР1асеЕгапе 





// список методов интерфейса ТО1еТпР1асеЕгаме 
НВЕЗОГТ 5ТОМЕТНООСАЬШОТУРЕ Егаше ОцегуТпфетРасе ( 
ТО1е1тР1асеЕгаше ЕАВ* Ехаше, ВЕЕТТО г11а, ГРУОТР ЕАВ* рруОр]); 
НВЕЗОГТ ЗТОМЕТНООСАШИТУРЕ Егаше АЗЯВеЕ ( ТО1етпР1асеЕгате ЕАВ* Егате); 
НВЕЗОГТ ЗТОМЕТНОРСАТЬТУРЕ Ехгаше _Ве1еазе ( ТО1еТпР1асеЕггаше ГАВ* Егаще); 
НВЕЗОГТ ЗТОМЕТНОРСАТГТУРЕ Ехгаше СефМ1таом ( ТО1еТиР1асеЕгате ЕАВ* Егаме, 
НИМО ЕАВ* ]рБмпа); 
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НВЕЗОЬТ ЭТОМЕТНОРСАЬЬТУРЕ Егате_Сопеехе5епз1&1уеНе]р ( 
ТО1е1пР1асеггаше КАВ* Егаше, ВООГ ЕЕпфеуМоае); 
НВЕЗОЬТ ЗТОМЕТНОРСАЬЬТУРЕ Егаше_ СекВогаег ( ТО1еТпР1асеРгаше ЕАВ* Егаще, 
ТРВЕСТ ]1ргес%Вогаег); 
НВЕЗОГТ ЗТОМЕТНОРСАТЬЬТУРЕ Ехаше Веааез«Вогаегбрасе ( 
ТО1етпР]1асеЕгаме ЕАВ* Егаше, ГРСВОВРЕВИТОТН$ ррогхае’хм1АеН$); 
НАЕЗОРТ ЗТОМЕТНООСАШТУРЕ Егатше Зе%Вог4дег5расе ( 
ТО1е1тпР1асеЕгаме ГАВ* Егаше, ТРСВОВРЕВИТОТН$ рро’гехм1АИз); 
НВЕЗОГТ ЗТОМЕТНООСАЬЬТУРЕ Ехгаше ЗекАсе1уеОю)есе ( 
ТО1еТоР1асеггаше ЕАВ* Егаше, ТО1еТпР1асеАс®1уе0Ю]ес®* рАсе1уе05)еск, 
ТРСОШЕЗТВ рз2ОБ]Маше); 
НВЕЗОГТ ЗТОМЕТНООСАГЬТУРЕ Егаше ТпзегЕМепоз ( 
ТО1е1пР1асеЕгаше ЕАВ* Ехгаше, НМЕМО БтепабЬатеа, 
ТРОГЕМЕМОСВОПРИТОТН$ 1рМером1АеВ5); 
НВЕЗОГТ ЗТОМЕТНОРСАБГТУРЕ Ехаме 5еМепи ( ТО1еТпР1асеЕгате РАВ* Егапе, 
НМЕМО Блепобрагей, НОЪЕМЕМО ро1етепа, НИМО БупаАсе1уе0ю]ес®); 
НВЕЗОТТ ЗТОМЕТНОРСАЬЬТУРЕ Егаше КетоуеМмепаз ( 
ТО1е1пР1асеЕкаше ЕАВ* Егаше, НМЕМО Риепабватеа); 
НВЕЗОГТ ЭТРМЕТНОРСАТЬТУРЕ Егаше беб5кабазТехе ( 
ТО1еТпР1асеЕкате ЕАВК* Ехгаше, ГРСОЬЕЗТВ рз25$абазТехе); 
НВЕЗОГТ 5ТОМЕТНООСАШГТУРЕ Егаме Епар1еМоде1езз ( 
ТО1еТпР]1асеЕгаше ЕАВ* Гхаше, ВООГ ЕЕпа1е); 
НВЕЗОЬТ 5ТОМЕТНООСАШЬТУРЕ Егаще_Тгапз]абеАссе1ека®охг ( 
ТО1еТпР]асеЕгаше ЕАВ* Егаше, ЬРМ5С 1ртза, МОВО мТО); 
// определяем порядок методов для виртуальной таблицы 
ТО1еТоР1асеЕГгате\ЕЮ1 ТО1еТпР]асеЕгатеМмефкоа$ = 
{ 
Егаше_ОцегуТпбет{асе, Егаше АЧЯВеЁ, Егаше Ве1еазе, Егаме_СбееИ1паом, 
Егапе СопфехЕ5епз1Е1уеНе1р, Егаше Се®Вогаег, Егаше Веаиез®Вогает5 расе, 
Егаше бе Вогаег5расе, Егаше ЗеъАсе1уеО6]ес®е, Егаше _Тпзег&Мепиз, 
Егаше бе Мера, ЕГгаше ВепоуеМепиз, Екаше бе 5фаСизТехе, 
Егаше Епар1еМоае1езз, Ехаше Тгапз1афеАссе1егафог 
}; 
// пишем расширенную структуру 
суреаеЕ зегасе 
{ 
ТО1етоР1асеЕгаме Егаше; // первый объект браузера 
НИМО ВгомзехИ1тЯом; // дескриптор окна браузера 
} ТО1етаР1асеЕкаме; 
// пишем реализацию методов интерфейса 
НВЕЗОГТ ЗТОМЕТНООСАТГИТУРЕ Егаше_ОцегуТпеегЕасе ( 
101еТоР1асеггаше ЕАВ* Егаше, ВЕЕТТО х119, ГРУОТО ЕАВ* рруоБ)) 
{ 
гебокп Е МОТ1МРГ; 
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НВАЕЗОГТ ЗТОМЕТНООСАЬГТУРЕ Егаше АааВеЕ ( 101еТпР1асеРгаше ГАВ* Егапше) 

{ 
гтебатп 1; 

} 

НВЕЗОГТ 5ТОМЕТНОРСАШОТУРЕ Егаше Ве1еазе ( ТО1еТпР1асеЕгаше ГАВ* Егапе) 
{ 

хебоуг 1; 

} 

НВЕЗОГТ $ТОМЕТНОРСАБЬТУРЕ Егаше Сеф\1п4Чом ( ТО1еТпР1асеЕгаме ЕАВК* Ехгапе, 
НИМО ЕАК* 1рЬута) 

{ 

// возвращаем указатель на окно браузера 
*]1рЬмпЯа = ( ( _ТО1еТаР1асеЕгаме*) Егате)->ВгомзегИ1таом; 
хебогп $_ОК; // выходим 

} 

НВЕЗОЬТ ЗТОМЕТНОРСАЬШОТУРЕ Ехапе Сопехе5епз1%1уеНе1р ( 
ТО1е1ТтР]асеЕгаме КАВ* Егаше, ВОО ЕЕпкеуМоае) 

{ 

тебого Е МОТ1МРГ; 

} 

НВЕЗОГТ ЗТОМЕТНОРСАШТУРЕ Егаше СефВогаег ( ТО1еТиР1асеЕгаше КАВ* Егапе, 
.РВЕСТ 1ргес%Вогаег) 

{ 

гебагп Е МОТТМРГ; 

} 

НВЕЗОГТ ЗТОМЕТНОРСАЬГТУРЕ Егаме Ведчиез®Вогаег5расе ( 
ТО1е1тР1асеЕгате КАВ* Егатше, ТРСВОВОЕВИТОТН$ рро’гаехгм1 Аз) 

{ 

гебагп Е МОТТМРГ; 

} 

НВЕЗОБТ ЗТОМЕТНООСАЦЬТУРЕ Егаше Зе Вог4ег$расе ( 

ТО1еТоР1асеЕгате ЕАВ* Ехатше, ГРСВОВОЕВИТОТН$ рро’Чехги1аВ$) 

{ 

тебаги Е_МОТТМРГ; 

} 

НВЕЗОРТ ЗТОМЕТНОРСАБЬТУРЕ Егаше бе Асе1уе0ю]есе ( 
101еТпР1асеЕгаше ЕАВ* Ехаше, ТО1еТпР]асеАс&1уе0О6]есе *рАсЕ1уеОБ]ес&, 
ТРСОГЕЗТВ рз2О]Машме) 

{ 

гебагп 5$ ОК; 

} 

НВЕЗОГТ ЗТОМЕТНООСАТЬТУРЕ Егаше_ТпзехЕМепиз ( 

ТО1е1тР1асеЕгаме ЕАВ* Ехгаше, НМЕМО рлепабрагеа, 
ТРОЬЕМЕМОСВО0РИТОТН$ 1рМепим1аАеЬ$) 
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геёокп Е МОТТМРГ; 
} 
НВЕЗОГТ ЗТОМЕТНООСАЬБЬТУРЕ Ггаше 5еМепа ( ТО]1еТГоР1асеЕгаше ЕКАВ* Егапе, 
НМЕМО риепабБахгеЯя, НОГЕМЕМО Во1етмепи, НИМО БмроаАсе1уеОю]ес®) 
{ 
тебикп 5_ОК; 
} 
НВЕЗОГТ 5ТОМЕТНОРСАЬГТУРЕ Егаше ВепоуеМегаз ( 
ТО1еТпР1асегхаше ЕАВ* Егаше, НМЕМО БпепабВагеа) 
{ 
гебагп ЕЁ МОТТМРГ; 
} 
НВЕЗОГТ ЗТОМЕТНОРСАБШЬТУРЕ Ггаше_ бе 5хабазТехе ( 
ТО1еТоР1асеЕгаше ЕАВ* Егаше, ГРСОШБЕЗТВ рз2б$абазТех®) 
{ 
гебагп $5_ОК; 
} 
НВЕЗОГТ ЗТОМЕТНООСАБЬТУРЕ Егаше _Епаю1еМоде1езз ( 
ТО1еТпР1асеЕгхгаше ГАВ* Ехаше, ВОО ЕЕпаю1е) 
{ 
гебагп 5_ОК; 
} 
НВЕЗОГТ ЗТОМЕТНООСАЦЬТУРЕ Егаме_Тхгапз]а$еАссе1еха®ог ( 
ТО1еТоР1асеЕгате ЕАВ* Егаше, ПРМ$С 1ртза, МОВО мТЬ} 
{ 
теёигп Е МОТТМРГ; 


Листинг 21.8. Реализация интерфейса тросНозЕОТНап91ег 


// список методов интерфейса ТРосНозЕОТНапЧ1ех 
НВЕЗОЬТ ЗТОМЕТНООСАШИТУРЕ ОТ_ОцегуТпеегЁасе ( 

ТРосНозе0ТНапЯ1ех ЕАВ* ОТНапа1ех, ВЕЕТТО г114, \%01а** рруОрдес®); 
НВЕЗОГТ 5ТОМЕТНОРСАЬГТУРЕ ОТ АЯаВеЕ ( ТРосНозеОТНапа1етг ЕАВ* ОТНапа1ег); 
НВЕЗОГТ 5ТОМЕТНОРСАШОТУРЕ ОТ_Ве1еазе ( 

ТРосНозОТНапа1ех ЕАВ* ОТНапа]1ег); 

НВЕЗОГТ ЗТОМЕТНООСАЦТУРЕ ОТ _ЗПомСопеехЕМепа ( 

ТОосНоз®01НарЯ1ех ЕАВ* ОТНапЧ1ех, ОМОВО амТО, РОТМТ _ ВРС _ГАВ*ррф, 

ТОпкпомт _ ВРС _ЕАВ* рст@ЕВезегуеЧ, Т01зрафсЬ _ ВРС ЕАВ* ра1зрВезегуед); 
НВЕЗОГТ ЗТОМЕТНООРСАШОТУРЕ ОТ _СбекНоз&Тто ( 

ТРосНоз0ТНап91ег ЕАВ* ОТНапЯ1етг, РОСНОЗТОТТМЕО _ ВРС _ГАВ* ртпРо}; 
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НВЕЗОГТ ЭТОМЕТНООСАЬЬТУРЕ ОТ_5ВомОТ ( ТРосНозеОТНапЯ1ет ЕАВ* ОТНапо1ег, 
РИОВО @мТр, ТО1еТаР1асеАс&1уе06)есе _ ВРС _ГАВ* рАсе1уе0Ю)еск, 
ТО1еСоштаптЯТагаее __ВРС_ЕАВ* рСомтапаТагаех, 

ТО1еТиР1асеЕкаме __ВРС_ЕАВ* рЕгапе, 
ТО1]етирфасетТИ1таом _ ВРС _ГАВ* рОос); 

НВЕЗОГТ ЭТОМЕТНОРСАШИТУРЕ ОТ_Н1ае0т ( ТросНоз®ОТНапЯ1ет ГАВ* ОТНапо1ег); 

НВЕЗОЬТ ЗТОМЕТНООСАШИТУРЕ ОТ _Ораафеот ( 
ТРосНоз<ОТНапа1ег ЕАВ* ОТНапо1ехг); 

НВЕЗОГТ ЗТОМЕТНООСАЬЬТУРЕ ОТ_Епаю1еМоде1езз ( 
ТРосНозОТНапЯ1ех ЕАВ* ОТНара1ех, ВООГ ЕЕпаБ1е); 

НВЕЗОГТ ЗТОМЕТНОРСАГГТУРЕ ОТ_ОпросиИ1паомАс®1уафе ( 
ТРосНозОТНапа]1ег ЕАВ* ОТНапЯ1ет, ВООЬ ЕАсЕ1уафе); 

НВЕЗОБТ ЗТОМЕТНОРСАЦИТУРЕ ОТ ОпЕгамей1паомАсе1уафе ( 
ТРосНозОТНара1ех ЕАВ* ОТНапЯ]ех, ВОО ЕАсе1уасе); 

НВЕЗОГТ 5ТОМЕТНОРСАБИТУРЕ ОТ Вез12еВогаег ( 

ТРосНозОТНапа1ех ЕАВ* ОТНапЧ1ех, ГРСВЕСТ ргсВогаег, 
ТО1е1пР1асебтТИ1п9ои _ ВРС_ЕАВ* рОТИ1паом, ВОО ЕВатей1таом); 

НВЕЗОГТ УТОМЕТНООСАШЬТУРЕ ОТ _ТгапзфафеАссе1ехавог ( 
ТросНозОТНапа1ехг ЕАВ* ОТНапЯ1ег, ТРМ$С 1рМзд, 
соп5& СОТ __ ВРС ЕАВ* роч1АСтабгопр, РБМОВР пСмато}; 

НВЕЗОГТ 5ТОМЕТНОБСАБОТУРЕ ОТ_бефОре1опКеуРа®т ( 
ТРосНозОТНапа1ех ЕГАВ* ОТНапЯ]1ех, ГРОБЕЗТВ __ВРС_ЕАВ* рсПКеу, 
ОМОВО @4м); 

НВЕЗОГТ ЗТОМЕТНОРСАБЬТУРЕ ОТ сбебогорТагдее ( 

ТРосНо$ОТНара]1ех ЕАВ* ОТНара]ех, ТРЮгорТагдее __ВРС_КАВ* рОгорТагде®, 
ТРгорТагдее __ВРС_ЕАВ* __ ВРС ЕАВ* ррОгорТахдеф); 
НВЕЗОГТ 5ТОМЕТНОРСАЬБОТУРЕ ОТ_бефЕхкегпа1 ( 

ТросНозОТНапа1ех ЕКАВ* ОТНапа1ех, 

Т015рафсв __ВРС_ЕАВ* _ ВРС ЕАВ* ррО1зрафсВ); 
НВЕЗОГТ ЭТОМЕТНООСАБЬТУРЕ ОТ Тхапз}а®еЦх1 ( 

ТросНозеОТНапЯ1ех ЕАВ* ОТНарЯ1ех, ОМОВОР АмТгап$1ахе, 

ОТЕСНАВ __ ВРС _ЕАВ* рсвОВЬТп, ОБЕСНАВ __ВРС_ЕАВ*__ВРС ЕАВ* ррсповЬОйе); 

НВЕЗОГТ 5ТОМЕТНОРСАЦОТУРЕ ОТ Е11$еграбаОБ)]ес® ( 

ТРросНоз ОТНапа1ех ЕАВ* ОТНапЯ91ех, ТРабаОр)]есе ВРС _ГАВ* роО, 
ТРабаОЮ]есё __ВРС_ЕАВ* _ ВРС _ЕАВ* рррОВеф); 

// определяем порядок методов для виртуальной таблицы 

ТросНозОТНапЯ1ет\/&Ю1 ТросНозИТНарЯ1ехМеекоа$ = 
{ 

ОТ ОпегуТпеегЕасе, ОТ АааВеЕ, ОТ _Ве1еазе, ОТ_5ПоиСопфех&Мепо, 

ОТ бееНозЕТтЕо, ОТ _5Вомот, От Н1аеот, ит _Ордаже0т, ОТ Епар1еМоде1езз, 
ОТ_Опроси1паомАСе1тафе, ОТ ОпЕгатей1паомАсе1уахе, ОТ Вез1хеВогаег, 

ОТ Ткапз1а$еАссе1егафог, ОТ бесОре1опКеуРа®И, ОТ СеерохорТагде®, 

ОТ СебЕхфегпа1, ОТ Тхапз1а®е0х1, ОТ_Е11СеграсаОр]есе 

}; 
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// пишем реализацию методов интерфейса 
НВЕЗОГТ 5ТОМЕТНООСАЦЬТУРЕ ОТ_АЯЧВеЕ ( ТРосНозеИТНапЯ1ех ЕАВ* ОТНап1ех) 
{ 

хебагп 1; 

} 

НВЕЗОПТ 5ТОМЕТНООСАЦЬТУРЕ ОТ_Ве1еазе ( ТРосНозеОТНапЯ1ехг ЕАВ* ОТНап ег) 
{ 

хееауп 1; 

} 

НВЕЗОГТ 5ТОМЕТНООСАГЬТУРЕ ОТ_5помСопеехеМепа ( 

ТросНозеОТНапЧ1ег ГАВ* ОТНапа1ех, ОМОВР @мТр, РОТМТ _ ВРС ЕАВ* ррё, 
ТОпкромп _ ВРС_ЕАВ* рстаВезегуеая, Т21зраесВь _ ВРС ЕАВ* рЯ1зрВезегуея) 
{ 

гебагп 5_ОК; 

} 

НВЕЗОГТ ЗТОМЕТНООСАЦИТУРЕ ОТ_беЕснозеТптЕо ( 

ТросНозОТНап91ех ЕАВ* ОТНап1ех, ПОСНОЗТОТТМЕО __ВРС_ЕАВ* рТпЁо) 

{ 

// инициализация и установка внешнего вида окна просмотра 

рТпЕо->сЬ$12е = з1хеоЁ ( РОСНО$ТОГТМЕО); 

// устанавливаем плоскую линейку прокрутки и рамку окна 

рЕп1Ео->АмЕ1аачз = РОСНОЗТОТЕБАС ЕЪАТ_5СВОШЬВАВ | 
ПОСНОЗТОТЕБАС ЕЪАТ_5СВОШВАВ; 

// устанавливаем реакцию на двойной щелчок мыши 

рТпЕо->амПоцЬ1еС11ск = БОСНОЗТОТОВЬСЬК ОЕРАОГТ; 

гебигп $_ОК; 

} 

НВЕЗОГТ ЗТОМЕТНООСАЦЬТУРЕ ОТ_5ПомОТ ( ТРосНозеОТНапЯ1ех ЕАВ* ОТНапо1ехт, 
РМОВР АмТО, ТО1етТпР1асеАс®1уе0Ор]есе __ВРС_ЕАВ* рАс®1уеОЮ)ес®, 
ТО1еСоттапЯТагдаее __ВРС_ЕАВ* рСоптапЯТахгае*, 

ТО1етТпР1асеЕгаме __ВРС_РАВ* рЕкапе, 
ТО1еТпР1асейТИ1паом __ ВРС_ГАВ* ррос) 
{ 

гебагп $_ОК; 

} 

НВЕЗОГТ ЗТОМЕТНООСАЦЬТУРЕ ОТ_Н1ае0Т ( ТроснозеОТНапЯ1ех КАВ* ОТНапа1ет) 

{ 

теёскп 5_ОК; 

} 

НВЕЗОГТ 5ТОМЕТНООСАЬЬТУРЕ ОТ Ордафеот ( 
ТРосНоз&ОТНарЯ1ех ЕАВ* ОТНапО1ег) 

{ 

гебагп 5_ОК; 
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НВЕЗОГТ $ТОМЕТНОРСАТШТТУРЕ ОТ_Епаю1еМоде1езз ( 
ТлосНоз 01Нап91ег ЕАВ* О]ТНапЯ1ех, ВООГ ЕЕраБ1е) 

{ 

тебигп 5 ОК; 

} 

НВЕЗОТГТ $ТОМЕТНОРСАЦЬТУРЕ ОТ_ОпрбосИ1паомАсе1уаее ( 
ТросНозЕОТНапЯ1]ег РАВ* ОТНапЯ1етг, ВООЬ ЕАсе1уаке) 

{ 

тебиги 5 ОК; 

} 

НВЕЗОРТ ЗТОМЕТНООСАЦЬТУРЕ ОТ_ОпЕгатмем1таомАсе1хуаее ( 
ТросНоз ОТНапЯ]етг РАВ* ОТНапЯ1ет, ВОО ЕАс®1тафе) 

{ 

гебагп 5 ОК; 

} 

НВЕЗОГТ $ЗТОМЕТНОРСАЦЬТУРЕ ОТ_Вез12еВогаег ( 
ТросНозЕО0ТНапа1ег ЕАВ* ОТНапа1ег, ЬРСВЕСТ ргсВогаег, 
ТО1еТпР1асей1ТИ1паом __ВРС_РАВ* рОТИ1паом, ВООЬ ЕВатеМ1паом) 
{ 

тебигп $ ОК; 

) 

НВЕЗОГТ ЗТОМЕТНООСАЬЬТУРЕ ОТ_Ттапз1акеАссе1егаеог ( 
ТЛосНоз0ТНапЯ1ег КАВ* ОТНапа]екг, ЬРМ$С 1РМзд, 
сопзЕ СОТОЮ _ ВРС ЕАВ* рао1АСтабгоир, ОМОВО пСтато} 

{ 

тебагп $_РАГЗЕ; 

} 

НВЕЗОГТ ЗТОМЕТНОРСАЦИТУРЕ ОТ _беЕОре1опКеуРаей ( 
ТросНозОТНап91ег ЕАВ* ОТНап9]ег, РБРОГЕЗТВ __ВРС_РАВ* рсПКеу, ОМОВО ам) 

{ 

тееагп $ ЕАТЗЕ; 

} 

НВЕЗОГТ ЗТОМЕТНООСАТШЬТУРЕ ОТ _бееОгорТагцее ( 
ТросНоз®ОТНапа1ег ЕКАВ* ОТНапа1ет, ТОЮгорТагдее __ВРС_РЕАВ* рОгорТагдей, 
ТЮгорТагдее __ВРС_ЕАВ*_ _ВРС КАВ* ррОгорТагдее) 

{ 

тееагп $ ЕАГЗЕ; 

} 

НВЕЗОЬТ ЗТОМЕТНООСАЦЬТУРЕ ОТ_бебЕхеегпа1 ( 
ТРосНозЕОТНапа1ег ГАВ* ОТНап ег, 

Т01зрабсп __ ВРС_ГАВ* __ ВРС ГАВ* ррО1зраесп) 

{ 

*ррО1зраёсВ = 0; 
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тебакп $ _ЕАЬЗЕ; 
} 
НВЕЗОЬТ ЗТОМЕТНООСАБИТУРЕ ОТ Тхапз1а&е0т1 ( 
ТРосНозОТНапЯ]ег ЕАВ* ОТНапд1етг, ПОМОВОР @мТгапз1а%е, 
ОТЕСНАВ _ ВРС РАВ* рсвОВЬТп, ОГЕСНАВ _ ВРС РАВ* _ ВРС ЕАВ* ррсНОВГОие) 

{ 

*ррсьовЬОие = 0; 
тебигп $ КАБЬЗЕ; 

} 

НВЕЗОГТ ЗТОМЕТНООСАБЬТУРЕ ОТ_Е11феграфаОБ)есь ( 
ТРосНоз®ОТНара1етг ЕАВ* ОТНап@]ет, ТРафхаОБ)есе __ ВРС _РАВ* рро, 
ТРатаОБ)есе _ ВРС ЕАВ* _ ВРС ЕАВ* рррОВеф) 

{ 

*рррОБе+ = 0; 
тевики $ ЕАГ$Е; 


Как видите, реализация интерфейсов занимает много времени, но это необ- 
ходимое условие их использования. Вначале мы определили все методы ин- 
терфейса (в том числе и базового Топкпоит). После этого составили вирту- 
альную таблицу указателей на методы. Виртуальная таблица представляет 
собой массив указателей на методы интерфейса и позволяет динамически 
связать абстрактный метод с его реализацией. В завершении выполнили 
реализацию всех методов интерфейса. Не задействованные в программе ме- 
тоды оформили в виде "заглушек", просто вернув значение Е моттмРЬ. Опи- 
сание всех методов можно найти в документации фирмы Мгсгозой (напри- 
мер, на сайте). Для непосредственного управления возможностями браузера 
дополнительно понадобится еще один интерфейс тмеюВгомзег2, указатель на 
который мы получим по ходу программы. 


Теперь следует создать в редакторе пустой файл У!ебВго\ег.с, а в редакторе 
ресурсов — меню. Добавьте в меню пункт Ейе с подпунктами Ореп ОВГ и 
ЕхИ и пункт Вго\зе с подпунктами Ветезй, Со Васк, бо Еогуаг@, Эр, 
Ноше и Зеагсн. В дальнейшем идентификаторы подпунктов меню будут 
применяться для вызова тех или иных функций. 


На этом все основные операции закончены, и можно приступать к написа- 
нию основного кода программы. В листинге 21.9 показано, как это нужно 
сделать. 





Листинг 21.9. Основной код программы браузера в файле \УМебВго\мизег.с 


// макрос для подключения функции Со1п1&1а11теЕх 
+АеЕ1пе _М1М32_ рСОМ 

// подключаем необходимые файлы 

+1остаае <и1паомз.П> // общие функции №1132 
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#1псТаае <з691о.В> // работа с файлами 
#10с]10ае <ех41зр.В> // интерфейс ТЧеБВгомзег2 
#10] иае <азбеЬзе.65> // интерфейс ТРосНоз®ИТНапа]1ет 
// подключаем интерфейсы 
#1ос1аае "Т5еогаде. в" 
#1рс1иае "ТО1еТипР1асеЕгаме.В" 
#1ос1аае "ТО1еС11епё$ 1е.в" 
Н1ос1аае "ТросНозеОТНапоа1ег. В" 
НЯ1ос1таае "ТО1еТоР1асе$1ее. в" 
// определяем глобальные переменные 
ТРСТЗТВ 1рз2С1аззМаме = "ВгомзегС1азз"; // имя класса окна 
// общая структура поддержки интерфейсов 
суредеЕ эзёгасе 
{ 
ТО1еС11епЕ51Ее С11епе$1е; 
_ТО1етТпР1асе$1%е Р1асеб1{е; 
ТросНозеОТНапа1ег ОТ _Папа1ег; 
} ТО01еС11епё$1%е; 
// определяем функции 
ТВЕЗОРТ САБВАСК М1пдомМазпРгос ( НММО НМа1пМпа, ОТМТ пеззаде, 
МРАВАМ мРагап, 
ТРАКАМ 1Рагат); // главная функция окна 
10 АебасЬМ1паом ( НММО ЬМра); // присоединение окна браузера 
уо1А БебасвИ1паом ( НММО ВИпа); // удаление окна браузера 
уо1а Ве1еазеВгомзег ( НИМО БМа1пИпа); // завершение работы браузера 
уо1Я ЗромРаде (НИМО Бира, ГРТЗТВ ТРОВЬ); // загрузка веб-страницы 
// изменение размеров окна браузера 
у01Я Зее51тхей1паом ( НИМО Бира, 1орд м19В, 1опа Ве19Ве); 
уо1а ВеЁгезн ( НИМО В\па); // обновление страницы 
\01Я СбоВаск ( НИМО Ипа); // вернуться к предыдущей странице 
У014 СоГогмага ( НИМО Ь\па); // перейти к следующей странице 
уо1Я $Еор ( НИМО БИпа); // остановить просмотр страницы 
У014 ЗеагсВ ( НММО Бипа); // загрузить страницу поиска по умолчанию 
У01А Номе ( НММО ЬМра); // перейти на домашнюю страницу 
// основная функция программы 
116 САШЬВАСК М1пМа1п ( НТМУТАМСЕ РТпзбапсе, НТМ$ТАМСЕ ПРгемТпзвапсе, 
ТРУТВ 1рСаЯ1пе, 116 пСиа$Вом) 
{ 
М$С 59; // поддержка сообщений 
НИМО Б\па = МОБЬ; // дескриптор окна 
УМОСЬА$$ЕХ мсе; // расширенная структура окна 
// инициализируем объектную модель СОМ 
1Е ( СоТл161а112еЕх ( 0, СОТМТТ АРААТМЕМТТНВЕАОЕО | 
СОТМТТ ЗРЕЕР ОУЕВ МЕМОВУ) != $ ОК) гебакп -1; 
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} 


// обнуляем структуру окна 
2егоМепогу ( &мсе, з1теоЕ ( ИМОСЬАЗЗЕХ)); 
// определяем начальные свойства окна 
мсе.сю512е = з1теоЕЁ ( ИМОСТАЗЗЕХ}; // размер структуры 
исе.ВТрзфапсе = БТпзбапсе; // дескриптор программы 
исе.з6у1е = С$ НВЕОВАИ | С$ УВЕШВАИ; // стиль окна 
мсе.1рЕп\МрарРгос = И1паомМа1пРтос; // основная функция окна 
мсе.1рз2С1аззМаме = 1р$2С]аз$Маме; // имя для класса окна 
// дескриптор меню, созданного в редакторе ресурсов 
мсе.1рз2МепиМаме = МАКЕТМТВЕЗООВСЕ ( ТОВ МУМЕМО); 
// регистрируем созданный класс окна в системе 
Вед1зфегС1аззЕх ( &мсе); 
// создаем основное окно программы 
БИпЯ = СгеафеМ1паомЕх ( 0, 1рз2С1аззМаме, "Му Вгомзег", 
\5_ОУЕВЬАРРЕРМТМООЙ, СМ_ОЗЕРЕРАОПТ, 0, СИ _ОЗЕБЕЕАОПТ, 0, 
мОТЬ, БТозфарсе, 0); 

// выводим созданное окно на экран монитора 
Зо паом (ВИпа, пСпа$вом); 
// и перерисовываем его для удаления нежелательных эффектов 
Ордаеем1паом ( В\па); 
// запускаем цикл обработки сообщений 
\131е ( СекМеззаде ( &пза, 0, 0, 0)) 
{ 

Тгапз1акеМеззаде ( &51593); 

23 зраесЬМеззаде ( &мз49); 
} 
// освобождаем ресурсы СОМ 
Со0п4111а117е ()}; 
тевигп 0; 


// главная оконная функция 
ТВЕЗОШТ САБЫВАСК И1паомМалиРтгос ( НИМО ВМа1пМра, ОотТмТ пеззаде, 


{ 


МРАВАМ иРагаш, ПРАВАМ 1Рагат} 


// обрабатываем сообщения 

зм1еср ( пеззаде) 

{ 

сазе ИМ $12Е: // обработка размеров окна 


{ 


// изменяем размеры окна просмотра веб-страниц 


МОГ, 


Зез$1хем1таом ( ЮМаллМпа, ГОМОВО ( 1Рагам), НТМОВКО ( 1Рагам)}; 


} 


гегигп 0; 
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сазе ММ СВЕАТЕ: // создание окна 
{ 
// подключаем окно браузера 
1Е ( Аббаср\1лаом ( ЬМазо\та)) гебагп -1; 
// пытаемся загрузить страницу по умолчанию 
ЗВомРаде ( ЬМа1пИпа, БЕЁр: //мии. уапаех.гиа); 
} 
гевагп 0; 
сазе ММ $У$СОММАМО: // обработка системного меню 
{ 
зи1Еср ( мРагам & ОхЕЕЕО) 
{ 
сазе $С_С1О$Е: // выбрана кнопка закрытия окна или А] + Е4 
Ве1еазеВгомзег ( ПМа1п\Мпа); // закрываем браузер 
гебсагп ТВОЕ; 
ЧеЁал1е: // обработка по умолчанию 
ргеак; 


} 
ргеак; 
сазе ИМ СОММАМО: // обработка команд меню 
{ 
зм1Еср ( ТОМОВО ( мРагам) } 
{ 
сазе ТОМ ОРЕМ: // открытие файлов 
{ 


// определяем маску для файлов 


СВаг з7Е116егз[] = "НТМЬ Е11ез (1:1, Бе, \ 
Бет) \0*.иг1;*.Бем;* Бе \0\0"; 
свахг $20г1(МАХ РАТН] =" "; // путь 


ОРЕМЕТЬЕМАМЕ оЁп; 
// обнуляем и заполняем структуру данными 
2егоМетогу ( &оЁЕп, з1хеоЕ ( ОРЕМЕТЬЕМАМЕ)); 
оЕп.155гисЕ$51те = $з1теоЕ ( ОРЕМЕТШЕМАМЕ); 
оЕп.БипаОмпег = БМа1пМпа; 
оЕп.1рзЕЕЕ11(ег = $2Е116егз; 
оРп.1рзЕгЕ11е = $2011; 
оРп.пМахЕ1]е = з12еоЁ ( 20:1); 
оЁп.Е1адз = ОРМ НТРЕВЕАРОМЬУ | ОЕМ ЕТТЕМОЗТЕХТ$Т; 
// выводим на экран диалог для открытия файлов 
1Е( СееОрепЕ11еМаще ( &оЁп)) 
{ 

1706 с = 0; // код символа 

ЕТЬЕ* Е = МОБЬ; // дескриптор файла 
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// открываем файл для чтения 
Е = Еореп ( оЕп.1рзёеЕПе, "го"); 
// обрабатываем` файл 
у1211е ( 'ЕеоЕЁ (Е)} 
{ 
сн = дес (Е); // читаем символ 
// если это двоеточие, пытаемся прочитать адрес 
1Е ( ( ста’) сь == ':') 
{ 
сваг ©тр[100]; // временный буфер 
116 1 = 0; // счетчик 
// копируем начало адреса 
ЗЕгсру ( 3720.1, "ВЕёр:"); 
// выделяем из строки адрес страницы 
Бог (1; 1 < 100; 1++) 
{ 
{пр [1] = дес (Е); 
1Е ( 13ззрасе ( ( 1106) &пр[1])) 
{ 
Еир[1] = '\0'; 
эёгсае ( $270г1, пр); 
ово еп@; // выходим из циклов 


епа: 
1Е (Е) Ес1озе (Е); // закрываем файл 
// загружаем веб-страницу в браузер 


} 
ргеак; 
сазе ТОМ ЕХТТ: // выбран пункт меню Ех1ё 
Ве1еазеВгомзег ( БМа1п\па); 
гебагп ТВОЕ; 
сазе ТОМ ВАСК: // выбран пункт меню Со Васк 
СоВаск ( ЬМа1пИпа); 
ргеак; 
сазе ТОМ КОВМАВО: // выбран пункт меню бо Гогмага 
СоЕогчага ( НМало\па); 
Ъгеак; 
сазе ТОМ $ТОР: // выбран пункт меню 5®ор 
Зеор ( ЬМа1лИпа); 
ргеак; 
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сазе ТОМ ВЕЕВЕЗН: // выбран пункт меню ВеЁгезв 
ВеЁгезв ( ЮМа1оМпа); 
ргеак; 

сазе ТОМ НОМЕ: // выбран пункт меню Номе 

{ 
Нопе ( БМалоМпа); 

} 

ргеак; 

сазе ТОМ $ЕАВСН: // выбран пункт меню Зеагсй 
Зеагсь ( ВМа1оМпа); 
ргеак; 


} 
ргеак; 
сазе ММ РЕЗТВОУ: // завершение работы программы 
{ 
Ве1еазеВгомзег ( ПМа1п\оа); // закрываем браузер 

} 

гебагп ТВОЕ; 

} 


// обработка сообщений по умолчанию 


гееагпр БеРМ1паомРгос ( ВМа1пИрЯ, пеззаде, чРагам, 1Рагам); 


// функция закрытия окна браузера 
у0о1Я Ве1еазеВгомзег ( НИМО ЮМа1о\па) 


{ 


} 
// 


// удаляем окна браузера 
Бесасп\1паом ( БМалп\ра); 

// завершаем работу программы 
Роз01ЕМеззаде (0); 


присоединение окна браузера к главному окну программы 


11 АббасВИ1паом ( НИМО В\па) 


{ 


// объявляем указатели на интерфейсы 
ТО1е06)есё* Вгомзег; // объект для браузера 
ТмебВгочзег2* МеБВгомчзег2; // интерфейс поддержки браузера 
_101еС11епе51%е* 51%е; // внешний вид, свойства и сообщения браузера 
ВЕСТ г; // управление размером окна браузера 
сВаг* р = МОБ; // указатель 
// выделяем необходимый размер памяти для объекта браузера 
1Е ( !(р = ( сртаг*) С1ора1А11ос (СМЕМ ЕТХЕБ, 
312еоЕ ( 101е05)есё*) + з1теоЕ ( _101еС11епё$1%е)))) гебагп 1; 
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// инициализируем объект и определяем виртуальные таблицы методов 
316е = ( _101еС11ерё$16е*) ( з1теоЕЁ ( ТО1е06)есе*) + р); 
315е->С11епё5$1%е.1р\уЕю1 = &101еС11ере$16еМефодз; 
51е->Р1асе$1{е.Егаще .Егаме.1ру\УеЮю1 = &ТО1еТпР]асеЕгамемефоаз; 
$14е->Р1асе$1%е.Р1асе$1ее.1руУеЬ1 = &101еТпР1асе$1{еМекодз; 
$1Ее->0т_рапо]1ехг.1рУЬ1 = &ТРосНозеОТНапа]етхМефо@з; 

// копируем дескриптор главного окна программы 

31Ее->Р1асеб1ке. Егаме.ВгомзегтИ пом = В\па; 

// создаем объект браузера 

1Е ( 'О1еСгеафе ( &СЬ5Тр МебВгомзег, &тТтТ0 ТО1еО6)есе, ОБЕВЕМОЕК_ОВАМ, 


} 
} 


0, ( Т01еС11епЕ51%е*) 51%е, &_Т5еогаде, ( уо1а**) &Вгомзег)) 


// присваиваем указатель на полученный объект браузера 

*( ( Т01е06)есе**) р) = Вгомзег; 

// назначаем имя для полученного объекта 

Вгомзег->1рУЕЮ1->беНозЕМамез ( Вгомзег, 1"Вгомзег Нозе", 0); 

// сохраняем указатель для главного окна программы 

Зеё\1паоитопа ( Мпа, сбмь ОЗЕВОАТА, ( 10№) р); 

// получаем размеры клиентской части главного окна 

СееС11епЕВесе ( ЮМпа, &г); 

// сообщаем объекту браузера о внедрении его в наш контейнер ОБЕ 

1Е ( !О1ебееСопеалтедО6)есе ( ( зегисЕ ТОпКпомп*) Вгомзег, ТВОЕ) 
&& !Вгомзег->1р\у651->ОцегутиеегЕасе ( Вгомзег, &110 ТМерВгомзег2, 
( 7уо1а**) &МебВгомзег2) && !Вгомзег->1р\у6ю1->ПоУетЪ ( Вгомзег, 
ОТЕТУЕВВ ОТАСТТУАТЕ | ОБЕТУЕВВ_$НОМ, МОБ, 
( Т01еС11ерё51%е*) $1%е, -1, И\Маа, &г)) 


// устанавливаем начальные размеры окна браузера 
МеБВгочзег2->1р\у41->рие_ ТеЕЕ ( МеВгомзега, 0); 
ИМеБВгомзег2->1р\у4Ь1->риё_Тор ( МеБВгомзега, 0); 
ИебВгоизег2->1р\УЕЬ1->ри®_ М1аЕв ( МеБВгомзег2, г.г190); 
МерВгомзег2->1рУ&Ь1->риЕ_ Не1апе ( МеюВгомзег2, г.роббом); 
// уменьшаем счетчик ссылок на объект 
МерВгомзег2->1ру&Ю1->Ве]еазе ( МерВгомзет2); 

// выходим из функции 

тевагп 0; 


// освобождаем память 
С1оа1Етее (р); 

// выходим с ошибкой 
гевагп 1; 
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// освобождаем окно браузера 
у01Я РебасВИ1паом ( НИМ В\па) 
{ 
ТО1е0ор)]есе* Вгомзег = МОШЬ, **ТирВгомзег = МО; 
// получаем указатель на объект браузера 
1Е ( ( ТорВгомзег = ( 101е05)есё**) беёИ1оаомЬопа ( ВМпа, \ 
СИТ, ОЗЕВРАТА) } } 


Вгомзег = *ТирВгомзег; 

// останавливаем выполнение объекта и удаляем его 
Вгомзег->1рУ6р1->С1о5е ( Вгомзег, ОЦЕСТОЗЕ МОЗАУЕ); 
// уменьшаем счетчик ссылок на объект 
Вгомзег->1рУЕЬ1->Ве1еазе ( Вгомзег); 

// освобождаем выделенную ранее память 

С1оБа1Рхее ( ТирВгомзег}; 


} 


// получаем указатель на интерфейс ТРосНозЕ0ТНап1ет 
НАЕЗОЬТ УТОМЕТНОРСАЦИТУРЕ ОТ ОцегуТпсетЕасе ( 
ТРосНоз ОТНапд1ег РАВ* ОТНапа1ех, ВЕЕТТО 114, ГРУОТР ЕАВ* рруОоБ)) 
{ 
тебогп ( С11епЕ$16е ОцегуТпеегЕасе ( ( ТО1еС11ерЕ$1%е*) 
( ( сраг*) ОТНара1ех - з1хеоЕ ( ТО1еС11епЕ51%е) 
312еоЕ ( _ТО1етТаР1асе51%е)), х11а, рруор)}); 
} 
// получаем указатель на интерфейс 101еС11епё51{е 
НВЕЗОБТ ЗТОМЕТНОРСАЦИТУРЕ С11еп{51%е ОчцегуТпеетГасе ( 
1Т01еС11епЕ51$е ЕАВ* С11епЕ516е, ВЕЕТТО г114, уо1а** рруОБ)ес®) 


{ 


1Е ( мемстр ( г11а, &ттр ТОркпомт, з12еоЁ ( ©6010)) | 
!летстр ( г119, &ТТр ТО1ес11епё51%е, з12теоЕ ( 6010))) 
*рруОю]есе = &( ( _ТО1еС14епЕ$1Ее*) С11еп516е}->С11епе51%е; 
е} зе 1Ё ( '!мешстр ( г11аА, &ТТО ТросНозеОТНапа1ет, з12еоЁ ( С0То)))} 
*ррубБ)есЕ = &( ( _101еС11епё514е*) С11епе$1%е)->0Т Вап]ег; 
е1зе 1Е ( 'мешспр ( г11а, &ТТР ТО1етаР1асе$1фе, з12еоЁ ( С01Тр)))} 
*рруОБ]есЕ = &( ( _ТО1ес11епе514е*) С11епё51%е) ->Р1асеб1{е; 
е1зе 


{ 

*рруОБ)есе = 0; 

теситги Е_МОТМТЕВЕАСЕ; // не удалось получить указатель 
} 


теёигп $ ОК; // указатель на интерфейс успешно получен 
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// получаем указатель. на интерфейс ТО1еТпР1асе$1ее 

НВЕЗОЬТ ЗТОМЕТНООСАГТУРЕ ТпР1асе ОцегутпеегГасе ( 
ТО1ТеТпР1асе$1ее ЕАВ* Егаще, ВЕЕТТО г114, ЬРУОТО ЕАВ* рруОБ)) 
{ 


хебагп ( С11епЕ516е Оцегу!ТпеегЕасе ( ( 101еС11ере$1%е*) 
( ( спаг*) Егаме - з1теоЕ ( 101еС11епё$1%е)), гала, 
ррУоь))); 


} 
// определяем параметры окна для объекта браузера 
НВЕЗОГТ ЗТОМЕТНОБСАЬЫТУРЕ ТпР1асе_беЕ\И1паомСопеехе ( 
ТО1еТрР1асе516е ГАВ* Р1асеб16е, ГРОТЕТМРЬАСЕЕВКАМЕ ГАВ* 1р1рЕгапе, 
ТРОБЕТМРЬАСЕОТИТМООЙ ЕАВ* 1р1р0ос, ПРКЕСТ 1ргсРозВесе, 
ТРВЕСТ ]ргсС11рВес®е, ЬРОЬЕТМРЬАСЕЕКАМЕТМЕО 1рЕгатшеТпЕо) 
{ 
*]1р1рЕгаще = ( .РОЬЕТМРЬАСЕЕКАМЕ) & ( ( 
_ТО1еТпР1асе$1%е*) Р1асе$16е)->Егапе; 
*1р1ррос = 0; // то же самое окно для документа 
// заполняем информационную структуру для окна контейнера 
]рЕегаметпРо->ЕМОТАрр = ЕАГЗЕ; // не МоТ-приложение 
// дескриптор окна контейнера верхнего уровня 
1рЕгамеТоРо->ВипаЕгаме = ( ( _ТО1етпР1асеЕгаме* ) 

*]р1рЕгапе) ->ВгочзегУ1п9ом; 
1рЕгащеТоРо->Бассе1 = 0; // дескриптор таблицы акселераторов 
1рЕгапеТрЕо->сАссе1Епег1ез = 0; // число таблиц 
тебатп $ ОК; 

} 
// функция для загрузки веб-страницы 
у0о1А ЗромРаде ( НИМО Мпа, ГРТЗТВ 1ровЦ) 
-{ 
ТО01е06)есе* Вгомзег; 
ТчебВгомзег2* ИербВгомзег2; 
УАВТАМТ ОВЬ; 
// получаем указатель на объект браузера 
Вгомзег = *( ( ТО1е0Б)есе**) бее\и1паомЪора ( ВИпа, сит ОЗЕВРАТА)); 
// подключаем интерфейс поддержки браузера 
1Е ( !Вгомзег->1рУ(61->Оцегу!ТпеегЕасе ( Вгомзег, &ТТЮ ТМеБВгочзега, 
( уо1а**) &МеБВгомзег2)) 


// инициализируем вариантный тип для указателя на адрес 
Уаг1апеТп1е ( &0ВЦ); 

// определяем тип переменной как В$ТВ 

ОВЬ.УЕ = УТ В$ТВ; 

{1ЕпаеЕ ОМТСОРЕ // если используется Оп1соа 


763 


764 Часть И. Общие методы программирования в И/тао\и$ 


испаг ** м &пр; 
РИОВО амИСВахбу2е; 
// определяем размер для символьного буфера 


@ИСвагбу2е = Мо1{1Вусетом1аеСвакг ( СР_АСР, 0, ПрРОВЬ, —1, 0, 0); 


// пытаемся выделить необходимое количество памяти 
1Е (1! м ср = ( мсВаг &*) б1оБа1А11ос ( СМЕМ ЕТХЕБ, 
312еоЕЁ ( исраг ®)* @ЧмМСВаг$уте))) 
чоео по щешогу; // не удалось выделить память 
// преобразуем в строку символов АМ$Т 


Ми11ВуееТой1аесвакг ( СР АСР, 0, 1РОВЬ, -1, м &тр, @мМСВак5уте); 


// копируем строку из буфера 
ОВЬ.ЬзекУа1 = $у5А11ос$%:1п49 (м тр 
// освобождаем память 
С1ора1Ркее (м %пр}; 

} 





`. 


#$е1зе 

// копируем строку без преобразования 

ОВЬ.Ь5еуУа1 = бузАТосбег1па ( ( сопзЕ ОТЕСНАВ*) 1рОовЦ); 
фепа1Е 


// если данные отсутствуют 
1Е ( 'ОВЬ.Ьз&туУа1) 
{ 


// освобождаем ссылку на интерфейс 
по мемогу: 
МерВгомзег2->1рУуЕЬ1->Ве1еазе ( МерВгомзет2); 
геёаги; 
} 


// загружаем указанную веб-страницу 


МеБВгомзег2->1рУ{Ь1->Мау1да&е? ( МерВгомзет2, &0ВЦ, 0, 0, 0, 0); 


// освобождаем ресурсы 

Уаг1ап®С1еахг ( &08В1); 

// освобождаем ссылку на интерфейс 
МеБВгомзет2->1р\У&Ь1->Ве1еазе ( МеБВгомзег2); 


} 
// функция для перехода к предыдущей странице 
уо1А СоВаск ( НММО В\па) 
{ 
ТЧерВгомзег2* МерВгомзет2; 
ТО1е0Б)ес&* Вгомзег; 
// получаем указатель на объект браузера 


Вгомзег = *( ( ТО1е063ес&**) СебиИлпаомГопа ( Мпа, си ОЗЕВРАТА)); 
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// получаем указатель на интерфейс ТИеБВгомзег2 
1Е ( !Вгомзег->1р\у451->О0щекуТпфетгЕасе ( Вгомзег, &ТТО_ТМерВгомзека, 
( уо14**) &меБВгомзег2)) 


// переходим к предыдущей странице 
МеБВгомзег2->1рУ{Ь1->СоВаск ( МерВгомзет2); 
// освобождаем ссылку на интерфейс 
МеБВгомзег2->1рУ{Ь1->Ве1еазе ( МерВгомзег2); 


} 
// функция для перехода к следующей странице 
у01А боГогиага ( НИМ В\та) 
{ 
ТИиерВгомзег2* МебВгомзет2; 
Т01е0Б}ес®е* Вгомзек; 
// получаем указатель на объект браузера 


Вгомзег = *( ( 101е0р3ес&**) бееиИ1паомТопа ( ВИпа, сиь ОЗЕКРАТА)); 
// получаем указатель на интерфейс ТМебВгомзехк2 
1Е ( !Вгомзег->1р\у651->ОчекуТп®егЕасе ( Вгомзет, &ТТО ТМеБВгоизето, 


( уо1а**) &МеьВгоизег2)) 


// нереходим к следующей странице 
МеБВгомзег2->1рУЬ1->СоЕКогмага ( ИМеБВгомзег2); 
// освобождаем ссылку на интерфейс 
МерВгомзег2->1руУ$Ь1->Ве1еазе ( МебВгомзег2); 


} 
// функция для остановки загружаемой страницы 
уо1А 5®ор ( НИМО Вила) 
{ 
ТмербВгомзег2* МерВгомзег2; 
ТО1е0)ес&* Вгочзек; 
// получаем указатель на объект браузера 
Вгомзег = *( ( ТО1е0Б}ес®**) Сес\1оаомТопа ( РИпа, сит ОЗЕВРАТА)); 
// получаем указатель на интерфейс ТИеюВгоизетг2 
1Е ( !Вгомзег->1рУ&51->ОщегутТпеекЕасе ( Вгомзег, &ТТО _ТМеюВгомзего, 
( уо14**) &МеБВгомзег2)) 


// останавливаем загрузку страницы 
МебВгомзет2->1р\/Ь1->5%6ор ( МерВгомзег2); 

// освобождаем ссылку на интерфейс 
МеБВгомзег2->1рУуЬ1->Ке]еазе ( Ме бВгомзег2); 
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// функция для перехода к домашней странице 
уо1Я Номе ( НИМО Вива) 
{ 
ТМеБВгомзег2* МеБВгомзег2; 
1Т01е0Б}есе* Вгомзег; 
// получаем указатель на объект браузера 
Вгомзег = *( ( ТО1еОБ}ес®**) Сееи1паомГопа ( ВИпа, сиг ОЗЕБРАТА)); 
// получаем указатель на интерфейс ТМебВгоизег2 
1Е ( !Вгомзег->1рУеЬ1->ОцегуТибекЕасе ( Вкомзехг, &ТТО ТМерВгомзег2, 
( уо1а**) &МерВгомзег2)) 


// переходим к домашней странице 
ИебВгоизег2->1ру&61->СоНоме ( МеюВгомзег2); 
// освобождаем ссылку на интерфейс 
МеБВгомзет2->1р\У&51->Ве1еазе ( МебВгомзет2); 


} 
// функция для перехода к странице поиска 
уо1А Зеагсв ( НИМО Б\па) 
{ 
ТчербВгомзег2* МеБВгомзег2; 
ТО1е0ь}есе* Вгомзег; 
// получаем указатель на объект браузера 
Вгомзег = *( ( 101е063ес&**) СбееИ1паомТопа ( В\Моа, сить ОЗЕВБАТА)); 
// получаем указатель на интерфейс ТИеБВгомзег2 
1Е ( !Вгомзег->1руЬ1->ОцегуТпеегЕасе ( Вгомзег, &ТТР ТМеБВгомзега, 
( уо14**) &МеьВгомзег?)) 


// переходим к поисковой странице 
МерВгомзег2->1рУЕЬ1->бобеагсь ( ИеБВгомзег2); 
// освобождаем ссылку на интерфейс 
МеБВгомзет2->1рУ&Ь1->Ве1еазе ( МебВгомзет2); 


} 
// функция для обновления текущей страницы 
уо1А КеЁгезь ( НММО БИипа) 
{ 
ТМебВгочзег2* МерВгочзег2; 
101е06)ес&* Вгомзег; 
// получаем указатель на объект браузера 
Вкомзек = *( ( ТО1е063ес®**) СееИлпаомЬопа ( ПИпа, сиг ОЗЕВРАТА)); 
// получаем указатель на интерфейс ТМебВгомзет2 
1Е ( !Вгоизег->1рУЕЬ1->ОцегуТпеег{асе ( Вгомзег, &ТТр_ТМеьВгомзега, 
( уота**) &МеБВгомзег?2)) 
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{ 
// обновляем текущую страницу 
МерВгомзех2->1рУ+Ь1-> ВеЁгезВ ( МерВгомзег2); 
// освобождаем ссылку на интерфейс 
МеБВгомзет2->1рУ+Ь1->Ве1еазе ( МеБВгомзег2); 


} 
// функция для обработки размеров окна браузера 
уо1а Зееблхемалраом ( НИМР В\Моа, 1опд млаев, 1опа Велав*) 
{ 
ТмеБВгомзег2* ИеБВгомзег2; 
ТО1е0Б)ес&* Вгомзег; 
// получаем указатель на объект браузера 
Вгомзег = *( ( 101е0Б)есе**) бееи1паомопу ( ВИпа, сиь ОЗЕВРАТА)); 
// получаем указатель на интерфейс ТИеюВгомзег2 
1Е ( !Вгомизег->1рУ461->ОцегупиегЕасе ( Вгоизег, &ТТО ТМерВгомзего, 
( хо1а**) &МеБВгоизет?2)) 


// устанавливаем новые размеры окна 
МеьВгочзег2->1ру61->рие МТаер ( ИебВгоизег2, и"1АЕП); // ширина 
МеБВгоч5ет2->1ру61->ри® Нелапе ( МебВгомзег2, Ве190®); // высота 
// освобождаем ссылку на интерфейс 

меБВгомзег2->1ру+Ь1->Ве1еазе ( МеБВгомзег?2); 


Скомпилируйте файл программы и оцените полученный результат. Если в 
момент запуска приложения связь с провайдером отсутствует, будет загру- 
жен стандартный диалог дозвонки. С помощью меню Ореп ОВЕЬ можно за- 
гружать файлы с расширениями Вит, Би и и! (ссылки на сайты из папки 
Избранное). Сразу хочу заметить, что алгоритм поиска адреса в файле очень 
примитивен и представлен только ради демонстрации одного из способов 
загрузки веб-страниц. В коммерческих программах потребуется написать 
более сложный анализатор файлов для получения корректной адресной 
строки. 


При желании можете самостоятельно добавить дополнительные возможно- 
сти, поддерживаемые интерфейсом тиебВгонзег2, а также обработку меню и 
сообщений внедренного объекта браузера. 


21.3. Загрузка файлов 


Важной составляющей современных браузеров является возможность сохра- 
нения файлов из сети на компьютер пользователя. Однако реализация этой 
задачи в некоторых программах оставляет желать лучшего, и разработчикам 
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приходится решать ее самостоятельно. Поскольку эта тема интересует мно- 
гих, Я постараюсь познакомить читателей с основами загрузки различных 
типов файлов из глобальной сети. 


Во-первых, условно разделим все потенциальные источники файлов на две 
части: поддерживающие протокол НТТР и протокол ЕТР. Существуют и 
другие протоколы передачи данных, но они нас в данном случае не интере- 
суют. Для каждого из указанных протоколов имеется набор сервисных и 
общих функций, позволяющих легко применять их на практике, не задумы- 
ваясь о тонкостях внутреннего строения и способов организации обмена 
данными. Чтобы подключить к программе функции Интернета, необходимо 
добавить в проект файл определений УИтше.в, а в опциях компоновщика 
установить ссылку на библиотеку УИше!. 1. 


Перед началом работы рекомендуется всегда вызывать функцию 
ТроеегпефбеСоппескеа${афе, чтобы проверить текущее состояние подключе- 
ния к сети. Если соединение активно, можно начинать инициализацию по- 
средством функции ТпеегпекОреп, в противном случае с помощью 
ТобегпесА&епрЕСоппес® следует активизировать диалоговое окно для уста- 
новки соединения с сетью. После этого можно открывать требуемый сете- 
вой ресурс и начинать чтение файла. Чтобы упростить использование функ- 
ций Интернета, напишем отдельный класс ромп1оааЕ11е. Пример реализа- 
ции такого класса показан в листингах 21.10 и 21.11. 


Листинг 21.10. Файл БомипоааЕПе.В класса Рот 1оа9Е11е 


// если вы работаете не с УС++.МЕТ, можно определить константы вручную 


+АеЕ1пе ТМТЕВМЕТ ВА$_ТМ5ТАЬТЕО 0х10 
+АеЕзпе ТМТЕВМЕТ СОММЕСТТОМ ОЕЕРЬТМЕ 0х20 
#+АеЕлпе ТМТЕВМЕТ СОММЕСТТОМ СОМЕТСОВЕР 0х40 


// файл определений для функций Интернета 
#1ос1аае <и1п1пее.в> 
// объявляем класс 
с1азз Бомп1оааЕ11е 
{ 
рУБ11с: 
рот] оааЕ11е (}; // конструктор 
—Роут1оаЯЕ11е (); // деструктор 
// открытые функции класса 
Боо1 1п161а112е ( Боо1 БСоппесе = Еа1зе); // инициализация 
// загрузка файла с НТТЬ 
10 СебЕ11е ( сопзЕ сКаг* аЧ9Чгезз, сопз® сраг* оп Е11е); 
// загрузка файла с ЕТР-сервера без информации о текущем состоянии 
116 безеТРЕ11е ( сопз® спаг* Ёбр а@агезз, сопз® спаг* 1п_Е11е, 
сопзЕ спаг* оцЕ Ё11е, сопз® сваг* ах = №); 
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// загрузка файла с ЕТР-сервера 
171 СеЕгТРЕ11еЕх ( сопзе спаг* Е&р аЧ@гезз, сопз® сваг* 1п_Е11е, 
сопз& сВаг* ом Е11е, сопз® сваг* 1х = МО); 
// установить прогресс-бар для получения текущего состояния 
уо1а Зе еРгодхезз ( НИМР ПРгодгеззВатг, Боо1 Ь5еф); 
// установить текстовое окно для вывода текущего состояния 
уо1а зее5+аказУ1ем ( НИМО ЬТехе, Ъоо1 Ъ5е+); 
// проверка модемного соединения с сервером 
Роо1 Т5МодетСоппесе1от (} { гебакп м_@ач5{а<еСоппесе1от & 
ТМТЕВМЕТ _СОММЕСТТОМ МОБЕМ; } 
// проверка соединения в локальной сети 
Боо1 Т5ЪАМСоппес®1оп () { кеёикп м амбеа®еСоппес® оп & 
ТМТЕВМЕТ СОММЕСТТОМ ЪАМ; } 
// проверка правильности соединения в локальной сети 
Боо1 Т5ТАМУа11а (} { гебагп м аб абеСоппесе1от & 
ТМТЕВМЕТ СОММЕСТТОМ СОМЕТСОВЕО; } 
// проверка наличия прокси-сервера 
Боо1 ТзРгоху () { кебагп ш амбтса&еСоппесе1оп & 
ТМТЕВМЕТ СОММЕСТТОМ _РВОХУ; } 
// проверка поддержки службы удаленного соединения 
001 ТЗВАЗ (}) { кебоагтп п Аиб$а&еСоппес®1от & 
ТМТЕВМЕТ ВАЗ ТМЗТАЦЬЕО; } 
// проверка автономного режима 
Боо1 Т5ОЕЕ11пе () { гебаго м @иб$хаееСоппес {оп & 
ТМТЕВМЕТ СОММЕСТТОМ ОЕЕЬТМЕ; } 


рглуа*е; 


}; 


НТМТЕВМЕТ юм рТобеупее; // дескриптор Интернета 

РИОКР м Яиб®а$еСоппесЕ1от; // состояние соединения с сетью 
НИМО п ПРгодтезз; // дескриптор прогресс-бара 

НИМО т _НТехе; // дескриптор окна для вывода текста 

Бооф м БТзРгодгезз; // включение контроля загрузки файла 
Ьоо1 п ЬТ55%аеи5; // включение информации о загрузке файла 
// окончание класса 


#1пс1аае "з&ЧаЁх.в" 
#1ос1иае "Бомп1оааЕ11е.в" 
#10с1аае <зеЧ1о.1> 

#101 аае <сопис®хг1.Н> 


// реализация класса 
Ромп1оаЯЕ11е :: Ромп1оааЕ11е (} 


} 
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// инициализируем переменные класса 
шп АТабегпее = МОГ; 

п Чи5какеСоппесе1юоп = 0; 

т ИРгодгезз = М; 

п РТзРгодгез$ = Еа15е; 

м _Р1Тз5хаеи$ = Га1зе; 

п _РТехЕ = МЫ; 


Рот] оааЕ11е :; -Ромп1оааЕ11е () 


{ 


} 


// закрываем дескринтор Интернета 
1Е ( м ВТобегпе®) ТпбегпесС]1озеНапЧ1е ( м ВТо®егпе®); 
тп рТабегпее = М0; 


Боо1 роиплоааЕ11е :: Тп1е1а112е ( роо1 ЮСоппес®} 


{ 


} 


// проверяем состояние соединения с сетью 
1Е ( !ТобегпесбееСоппесееа5 таке ( ма _Чм5$а$еСоппес®1от, 0))} 
{ 
// если надо, выводим на экран окно установки соединения 
1Е ( БСоппес®) 
{ 
1: ( Гбегпе<сАесетреСоппесе ( 0) != ЕВВОВ_ $0ССЕЗ$) 
гефитп Га]1зе; 
} 
е1зе // иначе выходим с ошибкой 
тебигп Еа15е; 
} 
// если автономный режим, выходим из функции 
1Е( па аибафеСоппесе1оп & ТМТЕВМЕТ СОММЕСТТОМ ОЕЕРЫТМЕ) 
гегагп Еа1зе; 
// инициализируем функции Интернета для нашей программы 
м БГобегпее = Тобегре®Ореп ( "Муромп1оааЕ11е", 
ТМТЕКМЕТ ОРЕМ_ ТУРЕ ОТВЕСТ, МОШ., МОШЬ, 0); 
1Е ( м рТобеглее == МО) 
геёиги Ёа1зе; // ошибка инициализации 
гебагп Екиае; // ошибок нет 


уо1а Рочп1оааЕ11е :; ЗесбхабазУ1ем ( НИМО ВТехе, Боо1 Ь5еф) 


{ 


1Е ( п БТобеглпее) гебоагп; 
1Е ( 'РЮТехё) гебакп; 
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п РТехё = ВТех®е; // дескриптор окна для вывода информации 
т ЮТз5абиз = Ь5её; // включение информации о состоянии 
} 
уо1А Воип]оааЕ11е :: 5еёРгодгезз ( НИМЬ НРгоагеззВаг, Юоо1 5е®) 
{ 
1Е ( а Птобегпе®) гебоки; 
1Е ( '!ЮРкодгеззВак) гебагп; 
т ВРгодгезз = ВРгодгеззВаг; // дескриптор прогресс-бара 
п ЬТзРгодкезз = Ь5ее; // включаем использование прогресс бара 
} 
121 Боуп]оааЕ11е :: СбеЕЕ11е ( сопзе сраг* ааагезз, сопзЕ сраг* ом _Ё1]е) 
{ 
1Е ( п БТобегпее) гебиагп 0; 
// объявляем необходимые переменные 
ЕТЬЕ* рОйё = МОШ.; // дескриптор файла 
НТИТЕВМЕТ РОрепбекуех = №0; // дескриптор сервера 
сраг* ррБафа = МОТ; // указатель на буфер данных 
срак м $25%а5з[100]; // буфер состояния 
РМОВР 4мЕ11е512е = 0, ачВеааВуеез = 0, амСигБеаа = 0; 
РМОВР @мТумег = 100, амЕ1гзе = 0, амМехе = 0; 
БМОВО амВаЕЕехЬеп = з12еоЁ ( 4мЕ11е$12е); 
// открываем указанный сетевой ресурс НТТЬ 
ПОрепбегуег = Тпбегпе®ОрепОх1 ( м ВТпбегпее, аЧЯгезз, МОЦЬ, 0, 
ТМТЕВМЕТ ЕТЪАС ООМТ САСНЕ | ТМТЕВМЕТ ЕЪАС РВАСМА МОСАСНЕ, 0); 
1Е ( ПОрепбекуег == МОШ,) гефагп 0; // если ошибка, выходим 
// только для НТТР получаем размер исходного файла 
1Е ( !НЕброчегутиЕо ( ПОреп$егуег, НТТР_ ОЦЕВУ СОМТЕМТ_ЪЕМСТН | 
НТТР ООбЕВУ ЕТАСб МОМВЕВ, ( ТРУОТО) &9мЕ11е51те, &амВоЕЁГегЬеп, МОШ.)) 
{ 
ТпсегпееС1озеНапа1е ( пОрепбегуег); // закрываем ресурс 
гебиагп 0; 
} 
// выделяем память под буфер 
рРаба = печ сваг [9мЕ11е512е + 1]; 
1Е ( ррафа == МО.) 
{ 
ТбегпеС1озеНапа1е ( БОрепЗегуег); // закрываем ресурс 
тебагп 0; 
} 
// открываем файл для записи 
1Е ( ( рОдЕ = Еореп ( очё Е11е, "мб")) == МОБЬ) 
{ 


Яе1ефе [1] рВафа; // освобождаем память 
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рБаба = МО; 
Тобегпе<С1озеНаптЯ1е ( ПОрепбегуег); // закрываем ресурс 
тебагп 0; 
} 
// если включен вывод информации о состоянии 
1Е (м 5155$ абаз) 
// получаем текущее значение работы системы в миллисекундах 
ЧмЕ1х3 = СесТтаскСоное (); 
// если включен прогресс-бар, инициализируем его 
1Е ( м РТзРгодге$$) 
ЗепаМеззаде ( м ПРгодгезз, РВМ ЗЕТВАМСЕ, 0, 
МАКЕГРАКАМ (0, @мЕ11еб1хе)); 
// запускаем цикл для чтения файла из сети 
ао 
{ 
// читаем данные из сети 
1Е ( '!ТобегпесВеаЯЕ11е ( ЮОрепбегуехг, рБафа, з1хеоЕЁ ( рбафа}, 
&АмВеаЯВу*ез) } 


Ес1озе ( роде); // закрываем файл 
Че1еее [] ррафа; // освобождаем память 
рбафа = МО; 
ТибегпеС1озеНап1е ( НОреп5$егуег); // закрываем ресурс 
тебигпт 0; 
} 
// записываем прочитанные данные в файл на локальном диске 
1Е ({ !9мЕ11е512е} // если файл прочитан полностью, выходим 
Ьгеак; 
е1зе 
Еиг1&е ( ррафа, з1хеоЁ ( сваг), ЧмВеааВу®ез, рОо®); 
// сбрасываем файловый кэш на диск 
ЕЕТазВ ( рОчф); 
// вычисляем текущее число прочитанных байтов 
ЧмСагВеаа += ЧмВеаЯВу%®ез; 
// если включен прогресс-бар, отображаем новое положение 
1Е (м Ь15Ргодгез$) 
{ 
ЗепаМеззаде ( м ВРгкодгезз, РВМ 5ЕТРОб, ( МРАВАМ) ЧиСитВеаа, 0); 
ОрЧафейлтаом ( пм ПРгодгезз); 
} 
// если включен вывод информации о текущем состоянии 
1Е (м Ю155%а6а$) 
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} 


{ 
// вычисляем число прочитанных байтов и скорость передачи 
Е1оа& Е& = 0; 
ЕЕ = ( Еоа®) амСогкВеаа; 
Ее /= ( ( Е1оа®) ЧмТищехг) / 1000.0Е; 
Е /= 1024.0Е; 
// форматируем данные о состоянии 
зрг1пеЕ ( м 25%абиз, "Веа@: %а КВ Това1: %а КВ \ 
ТгапзЕег: %1.1Е КВ/з", амСигВеаа / 1024, амЕ11еб$лте / 1024, 
// выводим данные на экран 
ЗепЯМеззаде ( м ЮТехе, ИМ ЗЕТТЕХТ, 0, 
( ТРАВАМ) ( ТРТЗТК) м $25%6а613); 
// обновляем окно вывода 
ОрЧасей1птаом ( м ВТех®}; 
Тпуа11Чахевес® (п РТехе, МОШ., Еа15е); 
// получаем следующий отсчет времени 
ЧмМехе = бееТаскСоцое (); 
амтТ1мег = ЧмМехе - амЕ1гзе; // вычисляем промежуток 
1Е ( ЧмТ1щег == 0) амТГшег = 100; 
} 
// уменьшаем остаток непрочитанных данных 
ЧмЕ11е512е -= амВеааВу%&ез; 
} мН11е (1); 
рВа*а [94мЕ11е512е] = МИ; 
// восстанавливаем, если нужно, начальное состояние прогресс-бара 
1Е ( м БТзРгодгезз) 
ЗепаМеззаде ( м ПРгодгезз, РВМ 5ЕТРОЗ, 0, 0); 
// закрываем файл 
1Е ( рОце) Ес1о5е ( роче); 
// освобождаем память 
1Е ( рРБаФа) ае1феёе [] ррВафа; 
ррафа = МОМ; 
// закрываем ресурс 
ТобегпееС1озеНапа1е ( ВОрепбегуег); 
гебиагп 1; // выходим из функции 


17 Боут1оааЕ11е :: СееЕТРЕ1]е ( сопз®Е сНаг* Е&р а@агезз, 


сопзе сваг* 1п_ЁЕ11е, сопзЕ спаг* оцё Е11е, сопэз®е спаг* @1г)} 


1Е ( ма ПТобеглее) гебагр 0; 

НТМТЕВМЕТ ПОрепбегуехг = №11; // дескриптор сервера 

// открываем ресурс на сервере ЕТР 

ПОрепбегуег = Тпфегпе<Соппесе ( м ВТпёегпеф, Еёр аЧагезз, 
ТМТЕВМЕТ ОЕЕАОТТ ЕТР_РОВТ, МОБ, МОГ, ТМТЕВМЕТ ЗЕВУТСЕ_ЕТР, 0, 
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Ее); 


0); 
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1Е ( 'БОрепбегуег) гебогп 0; // если ошибка, выходим 
1# ( 91) 


// если нужно, устанавливаем текущую папку на сервере ЕТР 
1Е (!ЕербееСиггепО1гесеогу ( БОреп$егуег, @1г)) 


Губегпе*С1озеНапа1е ( ПОрепбегуег); 
гееогп 0; 


} 

// читаем файл с сервера ЕТР 

1Е ( !ЕербефЕ1е ( БОрепбегуег, 1п Ё11е, об _#Е11е, ЕАЦЗЕ, 
ЕТЬЕ АТТВАТВОТЕ_ МОВМАГ, 
ЕТР ТВАМЗЕЕВ ТУРЕ ВТМАВУ | ТУТЕВКМЕТ ЕТАС ВЕТОАР, 0)} 


ТпбегпеС1озеНапа1е ( БОрепбегуег); // закрываем ресурс 
герагп 0; 
} 
Трбегпе*С1озеНарЯ1е ( ПОрепбегуег); // закрываем ресурс 
гееогп 1; // выходим из функции 
} 
11Е Бомт]оааЕ11е :: СефЕТРЕ11еЕх ( сопзЕ сраг* Ебр а@агезз, 
сопз® сваг* 1п #Е11е, соп5е сраг* обе Е11е, сопзе сБаг* г) 


1Е ( Ма БТобегпе®) тебогп 0; 

// объявляем переменные 

НТМТЕВМЕТ БОреп5егуег = МОБ, ВЕ&рЕ11е = №; 

ОМОЕР @мТмаег = 100, ОмЕ1гзЕ = 0, амМехё = 0; 

ОМОВОЬ ЯмСогВеаа = 0, амВеааВу®ез = 0; 

сВаг БоЁЁЕег[1024]; // буфер для данных 

СВаг м 5725%аа5 [100]; // ‘буфер для вывода информации 
ЕТЬЕ* росе = МОШЬ; // дескриптор файла 

// открываем ресурс на сервере ЕТР 


ПОрепбегуег = Тпбегпе*Соппесе ( м БТеегпее, Е&р_адагезз, 
ТМТЕВМЕТ _РЕКАОГТ ЕТР_РОВТ, МОЫ., МОШ., МТЕВМЕТ_ЗЕВУТСЕ_ЕТР, 
0, 0); 

1Е ( 'РОрепбегуег) гебогп 0; // если ошибка, выходим 

1Е ( 91) 


{ 
// если нужно, устанавливаем текущую папку на сервере ЕТР 
1Е (!ЕКербееСоггереО1тесеогу { ВОрепбегуег, @91г)) 
{ 
ТобегрееС1озеНапа1е ( ПОрепбегуег); 
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гефаги 0; 


} 

// открываем файл для чтения на сервере ЕТР 

1Е (!( БЕСРЕШе = ЕбрОрепЕ11е ( ПОрепбегуег, 1п _ЁЕ11е, СЕМЕВТС_ВЕАР, 
ЕТР ТВАМЗЕЕВ ТУРЕ ВЛМАВУ | ТМТЕВМЕТ ЕЪАС ТВАМЗРЕЕВ ВТМАВУ, 0))) 


Губегпе*С1озеНарЯ1е ( БОрепбегуег); 

гебоги 0; 
} 
// открываем файл для записи на локальном диске 
1Е {( ( роде = Еореп ( обё Е11е, "\%")) == МОБ) 
{ 

// освобождаем ресурсы 

ТосехпееС1озеНапа1е ( ВЕЕрЕШе); 

ТпфегпеЕС1о5еНапа1е ( ПОреп$егуег); 

гефогр 0; 
} 
// если включен вывод информации о состоянии 
1Е (м РТз5фаеа5) 

// получаем текущее значение работы системы в миллисекундах 

ЧмЕтЕзе = бесТтаскСошие (); 
// если у вас установлена УС++.МЕТ или обновлены файлы, 
// можно получить размер исходного файла, как показано ниже 
// БМОВО амблиенл = 0, амблхеШо = 0, @мЕ\1е$1те = 0; 
// 9мз1хео = ЕербефЕ11еб12е ( ВЕБрЕ11е, &Чмб1хен1); 
// дмЕ11е$1хе = ам9лхеТо | ( Чм91теН1 << 32); 
// далее следует изменить код как в функции СефЕ11е 
// если у вас УС++ 6.0, определение размера файла опускаем 
// запускаем цикл для чтения файла из сети 


// читаем данные из файла на сервере ЕТР 
1Е ( !ТобегреВеааЕ11е ( ВЕбрЕ11е, раЁЕег, 1024, &а\ВеааВуеез) } 
ргеаКк; 
// записываем данные в файл на локальном диске 
1Е ( !ЗмВеааВуеез) 
ргеак; 
е]5е 
Еиг1фе ( БоЕЕет, 517еоЁ ( спаг), ЧмВеаЯВу®ез, рОое); 
// сбрасываем файловый кзш на диск 
ЕЕТозЬ ( рОое); 
// вычисляем текущее число прочитанных байтов 
ФмСигВеаЯ += ЧмВеаЯВу*ез5; 
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// если включен вывод информации о текущем состоянии 
1Е (ш Р155$ав2$) 
{ 
// вычисляем число прочитанных байтов и скорость пердачи 
#]оае Е = 0; 
Ее = ( Е1оа®) амСогВеаа; 
Ее /= ( ( Е]1оа®) ЭмТщег) / 1000.0Е; 
Е /= 1024.01; 
// форматируем данные о состоянии 
эргтпЕЕ ( м з256абаз, "ВеаЧ: %а КВ ТгапзЁЕег: %1.1Е КВ/з", 
ЧмСотВеаа / 1024, 1%); 
// выводим данные на экран 
ЗепаМеззаде ( ш ПТехе, ИМ ЗЕТТЕХТ, 0, 
{ ТРАВАМ) ( ТРТЗТВ) м 5725%а® 13); 
// обновляем окно вывода 
ОрЧаееи1п4ои ( м ПТех®); 
Тпуа11Чахевесе ( м ПТехе, МОМ. Га1зе); 
// получаем следующий отсчет времени 
ЧМехе = бееТ1сКкСойте (); 
амТ1ег = ЧмМех® - амЕ1г$; // вычисляем промежуток 
3Е ( ОмТумег == 0) амТ1мег = 100; 
} 
} мр11е (1); 
// закрываем файл 
1Е ( рОце) Ес1озе ( росе); 
// закрываем ресурсы 
ТибегпееС1озеНара]е ( ВЕ&рЕ\1е); 
ТобегпееС1озеНапа]1е ( ПОреп5егуег); 
гесогп 1; // выходим из функции 


Класс рочп1оаЯЕ11е достаточно компактен и прост, но позволяет вполне 
свободно скачивать из Интернета практически любые файлы: Шт, р, гаг, 
ехе ит. п. 


Перед использованием класса всегда следует вызывать функцию 1п1е1а112е, 
которая проверяет состояние подключения к сети и инициализирует ресур- 
сы доступа к сетевым ресурсам. После этого можно с помощью функций 
ЗекРгодгезз и Зее$%аказУ1еи включить возможность проверки в реальном 
‘времени процесса загрузки файла. Для удобства дополнительно отслежива- 
ется текущая скорость выполнения операции. 


Чтобы скопировать файл из сети, нужно выбрать соответствующую функ- 
ЦИЮ: бееЕ11е (копирование файлов с сервера НТТР), сееЕТРЕ11е (копирова- 
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ние файлов с сервера ЕТР без вывода информации о ходе процесса) или 
СесЕТРЕ!1еЕх (то же самое, но с выводом текущей информации о состо- 
янии). 


Для загрузки файлов по протоколу НТТР выполняем следующие шаги: 


1. 


Открываем сетевой ресурс (НТТР или ЕТР) посредством библиотечной 
функции ТпеегпебОреп0г1. 


Определяем размер исходного файла с помощью функции НЕЕрозекуттЕо. 
Данная функция не поддерживает работу с серверами ЕТР. Для них су- 
ществует новая (для Пиегпеё Ехр]огег версии 5.0 и выше) библиотечная 
функция — гербесЕ11еб12е. В УС++ МЕТ она включена в файл 
Уиппе! И. Программисты, работающие в УС++ 6.0, могут обновить 
указанный файл или в общих настройках среды разработчика установить 
новый путь к подключаемым файлам. 


Открываем файл для записи на локальный диск. 


Поблочно (размер задается буфером) считываем сетевой файл и сохраня- 
ем на локальном диске. Для чтения файла применяется функция 
Тисегпе%ВеааЕ11е. 


После того как весь исходный файл прочитан, закрываем нелевой файл 
на диске и освобождаем открытый сетевой ресурс функцией 
ТпфегпееС1озеНапа1е. 


Для получения файла, размещенного на файловом сервере ЕТР, достаточно 
выполнить несколько операций: 


1. 


4. 


И напоследок приведу примеры работы с классом роип1оааЕ11е (лис- 
тинг 21.12). 





Открываем новый сеанс связи с сервером (ЕТР или НТТР), используя 
функцию ТоеегпесСоппесе. 


Если искомый файл расположен в каталоге, предварительно следует от- 
крыть этот каталог посредством функции ЕЕрзееСоггепеР1гескохгу. 


. С помощью функции ЕЕрбебкЕ11е считываем файл с сервера. Данная 


функция не вернет управление программе, пока весь файл не будет про- 
читан или пока не произойдет ошибка. 


Освобождаем открытый сетевой ресурс функцией тпеегпееС1озеНапа1е. 





: Листинг 21.12. Примеры использования класса Ромп1оа4Е11е 


#1пс1оае "РомпфоаЯЕ11е. В" 

// получаем дескрипторы элементов для слежения за ходом процесса 
НИМР БРходгеззВаг = Сееро]а1Т6ет ( 10149, ТОС _МУРВОСВЕ$$); 

НИМО Б5$$абозТехе = беео1атТеет ( 1019, ТРОС МУЗТАТОЗТЕХТ); 
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// объявляем класс 

Ромп]1оаЯЕ11е аомп; 

// инициализируем функции Интернета и при необходимости вызываем 

// стандартное диалоговое окно для установки соединения 

Чомт. 1п161а112е ( %ге); 

// включаем использование прогресс-бара 

Чомп.ЗеЕРгоагезз ( ПРгодгеззВаг, %гце); 

// включаем использование статистики 

Чоп. бе бфъасазУтем ( П5фафазТехе, $гае); 

// загружаем файл с сервера и сохраняем на локальный диск с новым именем 

Чомт.бефЕ11е ( "Вер: //ммм.музе.сов/Боок.24р", "С:\\Кп1да.21р"); 

// отключаем использование прогресс-бара 

Чочт. Зе Ргодгезз ( ПРгодгеззВаг, Еа15е); 

// загружаем музыкальный файл в формате МРЗ с файлового сервера 

// из каталога "раБ/прЗЕ11ез" 

от. сетЕТРЕ11еЕх ( "Е Ёр.аз1К.сом", "тадоппа.тр3", "С: \ \мааоппа .тр3", 
"руб/тр3Е11ез"); 


Вообще, набор функций для программирования Интернета гораздо шире 
представленного здесь. Думаю, читателям будет интересно самостоятельно 
изучить их, тем более что простота работы с ними доставляет поистине не- 
забываемое удовольствие. 


ГЛАВА 22 


Почта и сеть 


Всем. кто использует операционную систему УМт4о\5, известна "небольшая" 
программа ОиЙоок Ехргез$, позволяющая получать и отправлять почтовые 
сообщения, проще говоря, письма. Одним она нравится, другим нет. Судить 
о ее достоинствах или недостатках я не берусь, каждый делает свой выбор 
сам, но что делать, если программист хочет написать собственную почтовую 
программу или просто добавить в уже созданный программный продукт 
поддержку работы с почтой? Если во втором случае можно просто вызвать 
стандартную почтовую программу (тот же ОиЦооКк Ехрге$$) с помошью 
функции звез1Ехесиее (см. гл. 19), то в первом придется искать другие воз- 
можности. Вот об этом и пойдет речь в данной главе. Кроме этого, мы рас- 
смотрим важные моменты программирования сетей, неразрывно связанные 
с почтовыми службами. 


Для удобства восприятия информации все основные темы можно предста- 
вить в виде списка отдельных тем: 


1. Отправление почтового сообщения. 
2. Получение почтового сообщения. 
3. Использование сетевых функций 


22.1. Отправление почтового сообщения 


При работе с почтовыми сообщениями используется стандартный транс- 
портный протокол $МТР (Зипре Май Тгап$Еег Ргоосо!). Он традиционно 
базируется на управляющем протоколе передачи ТСР (Тгапзпизяюй Сопго| 
Ргогосо!), где ему отведен порт (канал передачи) под номером 25. ТСР под- 
держивает передачу 8-разрядных байтов. Данные же в протоколе $МТР по- 
строены на 7-разрядных символах АЗСИ, поэтому при передаче по каналу 
ТСР в каждом байте старший бит устанавливается в 0. Данные передаются 
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с одного компьютера на другой непосредственно с использованием одина- 
ковой транспортной службы, а также через один или более так называемых 
$МТР-серверов, подключенных с применением одинаковой транспортной 
службы. Для правильной работы промежуточного $МТР-сервера он должен 
иметь имя, совпадающее с именем почтового ящика адресата. Например, 
для почтового сервера Уап4ех назначено имя уапфех.ги (полное имя 
зтёр.уапёех.ги), которое совпадает с любым почтовым ящиком, зарегистри- 
рованным на данном сервере (например, попате@уапёех.ги). Работа по про- 
токолу ЗМТР происходит с помощью специальных команд. Синтаксис этих 
команд четко оговорен стандартом. После команды могут следовать допол- 
нительные параметры, а в завершении обязательно должны размещаться два 
управляющих символа: возврат каретки (код 00) и новая строка (код од). 
В конце основного текста письма необходимо разместить две пары управ- 
ляющих символов с точкой посередине. 


Кроме управляющих команд, протокол поддерживает специальные число- 
вые колы ответов, позволяющие обнаружить ошибки и сбои при передаче 
почтовых сообщений. Основные команды протокола ЗМТР перечислены 
в табл. 22.1. 


В приведенной таблице указаны полные названия команд, а в скобках при- 
водятся их сокращенные версии, непосредственно используемые в работе. 
Числовые коды ответов и их описание представлены в табл. 22.2. 


Таблица 22.1. Список основных команд протокола $МТР 


Имя команды 


Описание 

(принятое сокращение) 

НЕБО (НЕБО) Позволяет указать имя хоста (адресуемого ЗМТР-сер- 
вера) 

ЕХТ НЕЫО (ЕНЬО) Позволяет использовать дополнительные опции для 
управления почтовым сервером 

МАТЬ (МАТГ) Позволяет указать адрес одного или нескольких отпра- 
вителей почтового сообщения 

ВЕСТРТЕМТ (ВСРТ) Позволяет указать адрес получателя почтового сообще- 
ния 

РАТА (РАТА) Позволяет поместить передаваемые данные почтового 


сообщения в буфер 


ЗЕМР (ЗЕМО) Служит для инициализации передачи почтового сообще- 
ния одному или нескольким терминалам 


ЗЕМО ОВ МАТЬ ($0МЬ) Служит для инициализации передачи почтового сообще- 
ния одному или нескольким терминалам или почтовым 
ящикам 
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Имя команды 
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Описание 

(принятое сокращение) 

ЗЕМО АМО МАТЕ, (ЗАМЬ) Служит для инициализации передачи почтового сообще- 
ния одному или нескольким терминалам и почтовым 
ящикам 

ВЕЗЕТ (ВЗЕТ) Позволяет прервать текущую передачу почтового сооб- 
щения 

УЕВТЕХ (УВЕУ) Позволяет проверить правильность идентификации ад- 
ресата 

ЕХРАМЬ (ЕХРН) Позволяет проверить правильность идентификации спи- 
ска адресатов 

НЕБР (НЕЬР) Позволяет обрабатывать различную справочную инфор- 
мацию 

МОР (МОБ) Пустая команда 

оотт (оотт) Позволяет установить для адресата передачу положи- 
тельного ответа и закрыть канал связи 

товм (товн) Позволяет переопределить роль адресата на роль от- 
правителя 


Код 
211 
214 
220 
221 


250 


251 


354 


421 


450 


Таблица 22.2. Числовые коды ответов 


Описание 


Зумет $а\из, ог зу${ет Пе!р гер (состояние системы) 
Нер теззаде (справочное сообщение) 
<дота> Зег/се геаду (служба доступна) 


<дота> Зегусе с1озпд {гапзп!$юп спаппе! 
(канал передачи закрыт службой) 


Ведиез{е4 тай ас\юп окау, сотре{е4 
(требуемая почтовая операция успешно выполнена) 


Чзег по! [оса!; м!!! огумага {0 <югумаг4-райН> (для нелокального пользователя 
требуется указать полный адрес получателя) 


Зай тай приё епа мИн <СВЕР>.<СВЕР> (можно начинать передачу почто- 
вого отправления) 


<дотат> Зег/се по! ауайаЫе, 
сюда 1гапзтзюп спаппе! (служба занята, закрытие канала передачи) 


Аедиезе4 тай асйоп по {аКеп: тайЙБох ипауайаЫе 
(операция не выполнена, почтовый ящик недоступен) 
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Таблица 22.2 (окончание) 





Код Описание 
451 — Ведие$е4 асйоп абопед: еггог п ргосеззтд (ошибка обработки данных} 
452 Ведичез!е4 асйоп по! {аКеп: пзиНсеги зузет э‘югаде (недостаточно памяти) 
500 Зуах еггог, соттап@ ипгесодте4 (неправильная команда) 
501 Зутах епог т рагате{ег$ ог агдитеп$ 
(недопустимые аргументы для команды) 
502 Соттап4 по! итр!етегие4 (команда не поддерживается) 
503 Вад зедцепсе о! соттапа$ (ошибка последовательности команд) 
504 — СоттапЧ рагатеег по! трететед 
{параметры команды не поддерживаются) 
550 Ведиез!е4 асйоп по! {акеп: тайБох ипауайаЫе (почтовый ящик недоступен) 
551 Узег по! |оса!; реазе гу <юпмаг4-ра!> (для нелокального пользователя 
требуется указать полный адрес получателя) 
552 Ведие\е4 тай асбоп абопед: ехсее4е4 зюгаде аЙосайоп (ошибка памяти) 
553 — Недцез{е4 асйоп по! {аКеп: таЙБох пате по{ айомеЯ 
(недопустимое имя почтового ящика) 
554 Тгапзас#оп {айед (ошибка в работе) 


Использование возвращаемых кодов помогает синхронизировать запросы и 
команды во время передачи почтового сообщения. Каждый код состоит из 
трех числовых символов, за которыми следует определенное текстовое со- 
общение. 


В принципе, вот и все общие сведения о протоколе ЗМТР, с которыми мне 
хотелось познакомить читателя. Для программирования в У! т490\%5 этих 
данных более чем достаточно. Если же вы используете, например, УМХ, 
следует более детально ознакомиться с документацией на протокол. В за- 
вершении приведу некоторые ограничения, оговоренные стандартом: 


О максимальная длина имени домена не может превышать 64 символа, 


О максимальная длина имени пользователя не может превышать 64 сим- 


вола; 


С максимальная длина обратного (адрес отправителя) или прямого (адрес 
получателя) пути не может превышать 256 символов, включая разделите- 
ли и знаки пунктуации; 


О максимальная длина командной строки вместе с управляющим кодом 
{2 байта) не может превышать 512 символов; 


[№ 


[№ 
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максимальная длина получаемой в ответ строки с учетом ответных кодов 
и управляющего кода не может превышать 512 символов; 


максимальная длина текстового сообщения с учетом управляюшего кода 
не может превышать 1 000 символов; 


максимальное количество получателей, использующих буферизацию, огра- 
ничено числом 100. 


Для организации передачи почтового сообшения можно воспользоваться 
набором стандартных функций У! 132 АРГ для работы с сокетами. Чтобы 
подключить к проекту эти функции, достаточно добавить в начало кода 
файл определений УМ тзосК.й, а в опциях компоновщика определить ссылку 
на библиотеку \!52_ 32.16. Мы не будем создавать целый класс. вполне хва- 
тит одной функции, которая и возьмет на себя все управление пересылкой 
почтового сообщения на удаленный сервер сети. Пример такой функции 
представлен в листинге 22.1. 


Листинг 22.1. Отправка почтового сообщения по протоколу ЗМТР 


+1осТоде "зЕааЕх.р" 
#10с1а9е <итпзоск.В> 


#1пс1оАе <5®1о.П> // функция зрелпЪЕ 


// объявляем функции 
Боо1 5еп@Ма11 (); // пересылка письма 


Боо1 Тп1&боскее ( ВУТЕ палог, ВУТЕ п1пог); // инициализация библиотеки 
// функция для отправки письма 
роо1 Зеп9Мат1 () 


{ 


// готовим структуру письма 

сопзс сВаг* шза[] = "Рафе: 1 Аргк11 2005 10:11:12\к\п \ 
Его: попаме@5егуег. га\г\пТо: мурохвуапаех.га\к\п \ 
Зир]ес®: Рк1уеф\г\пПервое апреля - никому не верю. \хг\п"; 

// объявляем переменные 

ЗОСКЕТ зосК зир = М№МОШ.; // дескриптор сокета 

ЗЕгасЕ зоскКа@аг 1п аЧЯгез5; // структура для хранения адреса сервера 

сВаг зкафиз[300]; // буфер для возвращаемой сервером информации 

100 1Везц1Е = 0; // результат операции 

// инициализируем библиотеку сокетов и проверяем ее версию 

1Е ( '!1л16боскеф (1, 1)) гебаги Ра15е; 

// создаем новый канал связи ТСР 

зоск_зтер = зоскеё ( АЕ ТМЕТ, $ОСК $ТВЕАМ, ТРРВОТО ТСР); 

// если канал не создан, выходим из функции 

1Е(50сКк эр == ТМУАБТО 5ОСКЕТ) 

{ 

ИЗАС1еапор (); // выгружаем библиотеку сокетов №52 32.411 
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гебагп Еа1зе; 
} 
// заполняем адресную структуру 
аЧагезз.з1п_ роге = Неопз ( 25); // номер порта 
// сетевой адрес почтового сервера ( требуется получить у провайдера) 
аЧ9агез$.31п аЧ@г.з аааг = 1пеё аааг ( "123.233.232.100"); 
// тип адреса 
адагезз.31п_Еат11у = АЕ ТМЕТ; 
// устанавливаем связь с сервером по созданному каналу 
1Е ( соппесЕе ( зосКк этер, ( з6гасе зоскаЧаг*) &а@агезз, 

312еоЕ ( зоскаааг 1п))) 


// если ошибка 
сфозезоскее ( зоск_зпЕр); // закрываем канал связи 
ИЗАС1еапир (); // выгружаем библиотеку сокетов М$2_32.911 
гебагп Еа1зе; 
} 
// передаем письмо по установленному каналу связи 
1Вези1е = гесу ( зоск зар, эбабаз, 300, 0); // проверяем канал 
1Е { 1Веза1Е == ЗОСКЕТ ЕВКОВ) до$о еггог еп; // ошибка 
зЕасиз [1Веза1] = '\0'; // выделяем результат 
ОпЕриЕБероа5Ех:1па { збабиз); // выводим на консоль отладчика 
// передаем имя хоста 
зре1оЕЕ ( звабаз, "НЕБО %5\г\п", "уапаех. га"); 
зепа ( зоск_зтёр, збабаз, зЕг1еп ( збабаз), 0); 
// проверяем результат операции 
1Везц1Е = гесу { зоск_зиЕр, збаба$, 300, 0); 
1Е ( 1Везоф == ЗОСКЕТ ЕВВОВ) добо еггог епа; 
збасаз [1Вези1{] = '\0'; 
ОпЕрисрероа$ек1па ( збабаз); 
// передаем почтовый адрес отправителя 
зре1тпЕЕ ( эбабаз, "МАТЬ ЕВОМ;:<%5>\г\п", "ропаще@зегуег. га"); 
зепЯ ( зосК змёр, збабаз, зЕг]еп ( збаба$), 0); 
// проверяем результат операции 
1Вези1Е = гесу ( 5зосК эр, зкабиз, 300, 0); 
1Е ( 1ВезафЕ == ЗОСКЕТ ЕВКОВ) добо еггог епа; 
зсаба$ [1Веза1] = '\0'; 
ОцЕриерерчаег1та { збабаз); 
// передаем почтовый адрес получателя 
зретпЕЕ ( эбабаз, "ВСРТ ТО:<%$>\г\п", шурох@уапаех. ги); 
зепа ( зоск зтёр, збабаз, зег1еп ( збаба$), 0); 
// проверяем результат операции 
1Вез01е = гесу ( зоскК эпер, зтабаз, 300, 0); 
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1Е ( 1Везу1Е == ЗОСКЕТ ЕВКОВ) дофо еггог_епЯ; 
зЕаеаз [1Вези1%] = '\0'; 

ОпцЕриБерич5г1пя ( збаби$); 

// подготовка текста письма к отправке 

зреапЕЕ ( эзбабаз, "ОАТА \г\п"); 

зепа ( зоск эпЕр, зеабиз, $6г1еп ( з$аеа$), 0); 
// проверяем результат операции 

1Вези1Е = гесу ( зосК эпёр, збаба$, 300, 0); 

1Е ( 1Веза1Е == ЗОСКЕТ ЕВВОВ) дофо еггог епа; 
5таеаз [1Вези18] = '\0'; 

ОпераЕБераа5 Е г1п9 ( баз); 

// передаем текст письма 

зрелое ( збабаз, "%5\г\п.\г\п", 159); 

зепа ( зоск этЕр, збабиз, 3зЕг1еп ( 5бабаз), 0); 
// проверяем результат операции 

1Вези1Е = гесу ( зоск_зпр, збаба$, 300, 0); 

12 ( 1Веза1Е == ЗОСКЕТ ЕВВОВ) добо еггог епа; 
5Еаеаз [1Вези16] = '\0'; 

Оибри Бери 5г1п9 ( баба); 

// завершаем передачу 

зре1пЕЕ ( эеабаз, "ООТТ\г\п"); 

зепа ( зоск этЕер, збабаз, зег1еп ( 5$Саба$), 0); 


` 


// проверяем результат операции 
1Везо1% = гесу ( воск этёр, эзбабаз, 300, 0); 
1Е ( 1ВезаЪфЕ == ЗОСКЕТ ЕВВОК) добо еггог епа; 
зфаеаз [1Вези1{] = '\0'; 
СиЕроЕБербич5Ег1тя ( збабаз); 
// письмо успешно отправлено 
с1озезоскее ( зоск этЕр); // закрываем канал связи 
ИЗАС1еапир (); // выгружаем библиотеку сокетов \з2_32.911 
гебаги сгие; // выходим из функции 
// обработка ошибок 
еггог епа: 
с1озезоскее ( зосКк эр}; 
ИЗАС1еапир (); 
гебаги 2а1зе; // выходим с ошибкой 
} 
// функция инициализации библиотеки сокетов 
Роо1 Тп1Ебоскее ( ВУТЕ па)ог, ВУТЕ папог) 
{ 





// добавляем информационную структуру для сокетов 
ИЗАБАТА зоскееТоЕо; 

// добавляем переменные для хранения кода ошибки и версии 
МОКО и\егз1опбоскее; 

106 1Еггог; 
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// преобразуем составляющие требуемой версии 
мУегз1опбоскее = МАКЕМОВО ( па]ог, папог); 
// вызываем функцию ИЗА5сагеиар 
1Еггог = ИЗАЗЕагеар ( мУегз1опбоскее, &зоскееТаЕо); 
1Е ( 1Еггог != 0) 
{ 
// версия установленной библиотеки не подходит 
ИУЗАС1еапор (); 
гебаги Еа15е; 
} 
// версия библиотеки подходит, продолжаем работу 
гесаги Сгае; 


Итак, прежде всего необходимо убедиться в наличии библиотеки сокетов и 
инициализировать ее для работы. Для этого вызываем функцию изАзеахетр, 
передавая в качестве параметров старшее и младшее значения версии биб- 
лиотеки (в данном случае 1.1). В случае если файл библиотеки (\5$2_32.41) 
не удовлетворяет условию, выгружаем ресурсы сокетов с помощью функции 
ИЗАС1еапур. 


После успешной инициализации создаем новый канал связи, используя 
функцию зоскее. В качестве параметров задаем тип протокола связи (ТСР) 
и способ обмена данными. При условии успешного выполнения функция 
вернет дескриптор для вновь созданного сокета (канала связи). Далее вы- 
полняем настройку адреса и номера канала почтового сервера, заполняя 
поля структуры зоскаааг_1т. Номер канала всегда равен 25, а адрес сервера 
следует получить у провайдера услуг. Если все готово, устанавливаем соеди- 
нение с помощью функции соппесе и передаем почтовое сообщение на уда- 
ленный сервер. Для этого вызываем функции гесу И зепа. Первая функция 
служит для получения ответных сообщений, а вторая передает данные на 
почтовый сервер. Когда все данные переданы, закрываем канал связи 
(стозезоскее) и выгружаем библиотеку сокетов (изАС1еапир). Вот, в принци- 
пе, и все сложности. 


22.2. Получение почтового сообщения 


Для получения почты и управления почтовым ящиком используется прото- 
кол РОРЗ (Роя ОЁсе Рго!осо!). Он позволяет динамически обрабатывать 
почтовые сообщения, расположенные на сервере. Как правило, для связи 
применяется канал под номером 110, поскольку РОРЗ так же, как и ЗМТР, 
базируется на транспортном протоколе ТСР. Для управления почтой имеет- 
ся собственный набор команд. Каждая команда состоит из ключевого слова, 
параметров и обязательных завершающих символов: возврат каретки (код 00} 


Глава 22, Почта и сеть 787 


и новая строка (код од). Ключевое слово всегда отделяется от параметров 
одним пробелом. Длина любого из параметров не должна превышать 
40 символов. Протокол поддерживает два кода состояния, которые возвра- 
шаются сервером как результат операции: "+ок" (успешное выполнение) и 
"ЕВВ” (произошла ошибка). За кодом следует текстовое описание и симво- 
лы (06 и 0А). Иногда текст содержит несколько строк. При этом каждая 
строка завершается символами возврата каретки и новой строки, а послед- 
няя — дополнительным символом точки (код 2Е) и символами ори о. Спи- 
сок команд протокола РОР3З представлен в табл. 22.3. 


Таблица 22.3. Список команд протокола РОРЗ 


Имя команды Описание 


РЕБЕ [М] Удаляет сообщение под номером м из почтового ящика 

т [м] Получение списка сообщений (с указанием порядкового номера 
и размера) или указанного сообщения с номером н 

МООР Пустая команда 

РАЗ5 Ввод пароля пользователя 

отт Завершение связи 

ВЕТВ [М] Позволяет получить (повторно) сообщение с номером н 

ВЕТ Восстанавливает все сообщения, помеченные для удаления 

ЗТАТ Позволяет получить текущее состояние почтового ящика (количе- 
ство писем и используемый под сообщения размер ящика) 

ТОР [№] Позволяет получить заголовок сообщения м и определить число 
строк в основном тексте 

отоЬ [м] Возвращает уникальный строковый идентификатор для сообщения м 

ОЗЕВ Ввод имени пользователя 


Дополнительные сведения можно получить в документации на протокол 
РОРЗ. 


Рассмотрим простой пример, позволяющий получить информацию о коли- 
честве почтовых сообщений и о используемом размере почтового ящика 
(листинг 22.2). 





Листинг 22.2. Получение информации о состоянии почтового ящика 





#1пс1аае "зЕЧаЁх." 
#1ос1аае <и1азосКк.Н> 
#1ос1а9е <з61о.1> // функция зретпЕЕ 
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// объявляем функцию 
роо1 СпесКМа11Вох (); // проверка почтового ящика 
// реализация 
Боо1 СпескМа11Вох () 
{ 
ЗОСКЕТ зоск рор3 = МОМ; // дескриптор сокета 
зЕгисЕ зоскаЧаг 1п аЯагез$; // структура для хранения адреса сервера 
Бозфепе* 1пЕо_зегуег = МО; // информация о сервере 
СВаг заказ [300]; // буфер для обработки информации 
116 1Везо1 = 0; 
071$19теЯ 1опд рор зегуег = 01; 
// обнуляем структуру зосКаааг 1п 
петзее ( ваЧагезз, 0, 51=2еоЁ { зоскааак_1т)}; 
// инициализируем библиотеку сокетов и проверяем ее версию 
12 ( 'То1боскее (1, 1)) гебаги Еа1зе; 
// создаем новый канал связи 
зоСсК_рор3 = зоскее { АЕ ТМЕТ, $ОСК_ЗТВЕАМ, ТРРВОТО ТР); 
// если канал не создан, выходим из функции 
1Е(зоск рор3З == ТМУАЬТО ЗОСКЕТ) 
{ 
ИЗАС1еапир (); // выгружаем библиотеку сокетов Из2_ 32.911 
гебагп Еа1зе; 
} 
// получаем адрес почтового сервера 
рор зегуег = 1пеф аЧЧг ( "рор.уапаех.га"); 
// если ошибка 
1Е { рор_зегуег == ОхЕРЕЕЕЕЕЕ) 
{ 


// пытаемся получить информацию о сервере 


171Е0о_ зегуег = деспозерупаме ( "рор.уапаех.га"); 
1Е ( !11Е0_зекуег) // нет данных 
{ 
ИЗАС1еапир (); // выгружаем библиотеку сокетов Из2_32.911 


гебогп Еа15зе; 

} 

// сохраняем полученные данные 

щетсру ( &рор_зекуег, 1пЁо зегуег->п_аЧАг 113$Е[0], з12еоЕ ( 11%)); 
} 
// заполняем адресную структуру 
аЧагезз.з1п_Еап11у = АЕ ТМЕТ; 
аЧАгезз.з1п рогЕ = Беопз ( 110); // номер канала для РОРЗ 
мешсру ( ва4агез$.:1п_а4Яг, &рор_зегуег, з1=е0Е ( 11%)); 
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// устанавливаем связь с сервером по созданному каналу 
1Е ( соппесЕ ( зоск_рор3З, ( зЕгасЕ зоска@аг*) вааагезз, 
з12еоЁ ( зоска@аг 1п))) 


с1озезоскее ({ зосК рор3); // закрываем канал связи 
ИЗАС1еапир (); // выгружаем библиотеку сокетов Из2_ 32.4911 
гебигр Еа15е; 

} 

// проверяем готовность сервера 

1Ве5о1& = гесу ( зосК рор3, эбабаз, 300, 0); 

14 ({ 1Веза]Е == ЗОСКЕТ ЕВВОВ) добо еггог еп; // ошибка 

зсаеа$ [1Вези1{(] = '\0'; // выделяем результат 

ОпериЕБериа5Етг1иа ( збабаз); // выводим на консоль отладчика 

// посылаем имя пользователя 

зре1пёЕЕ ( збабаз, "ОЗЕВ %3\г\п", "1уаро\у"); 

зепа ( зоск рор3З, збабаз, зегТеп { эбабаз), 0); 

// проверяем результат операции 

1Веза1 = гесу ( зоск рор3З, эбабаз, 300, 0); 

1Е ( 1Везафё == ЗОСКЕТ ЕВВОВ) дофо еггог епяа; 

зсаса$ [1Вези1%] = '\0'; 

ОпцЕериЕБериа5г3па ( 5баба$); 

// посылаем пароль 

зрелое Е ( збабаз, "РАЗ$ %3\г\п", "зе078маа"); 

зепа ( зоск рор3З, звабиз, зЕг1еп ( збаёа$), 0); 

// проверяем результат операции 

1Ве5а1{ = гесу ( 5осК_рор3З, зкабаз, 300, 0); 

1Е { 1Ве5а1Е == ЗОСКЕТ ЕВВОК) добо еггог епа; 

зтаса$ [1Вези1] = '\0'; 

ОпериЕБероа5:г119 ( зКабаз); 

// получаем число почтовых сообщений и используемый размер ящика 

зрг1пЕЕ ( экабаз,"5ТАТ %3\г\п"); 

зева ( зоск рор3, збабаз, зЕг1еп ( збабаз), 0); 

// проверяем результат операции 

1Вези1Е = гесу ( зоскК рор3З, зкабиз, 300, 0); 

1Е ( 1ВезафЕ == ЗОСКЕТ ЕВВОВ) добо еггог_епа; 

зсасаз [1Везц%] = '\0'; 

ОпЕросрериа5 Е хг1па ( збабаз$); 

// завершаем связь с сервером 

зрешпЕЕ ( збабаз, "ООТТ %3\г\п"); 

зеп { 5осКк рор3З, збабаз, зЕг1еп ( з6абаз), 0); 

// проверяем результат операции 

1Вези1& = гесу ( зоск рор3, збабаз, 300, 0); 

1Е ( 1Вези1$ == ЗОСКЕТ ЕВКОВ) дофо еггог_епа; 
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зЕабсиз [1Вези1%] = '\0'!; 

ОцериЕВероа5Ег1па {( з6а®а$); 

// закрываем канал связи и выгружаем Из2_ 32.4911 

с1о5езоскеЕ { зоск_рор3); 

ИЗАС1еапор (); 

гебиги Егие; // операция успешно выполнена 
// обработка ошибок 
еггог епа: 

с1тозезоскее ( зоск рор3); 

ИЗАС1еапир (); 

гебагп #а15е; // выходим с ошибкой 


В представленном выше примере мы сначала устанавливаем соединение с 
почтовым сервером по протоколу РОРЗ. После получения ответа посылаем 
имя пользователя (логин) и пароль. Далее с помощью команды $тат опреде- 
ляем количество почтовых сообщений и использованный размер (в байтах) 
ящика. В завершении передаем серверу команду оотт. Вся информация, пе- 
редаваемая почтовым сервером, выводится на консоль отладчика (функция 
ОпЕриереьаа5Ек1т9). Сделано это исключительно ради удобства восприятия и 
лучшего понимания работы протокола РОРЗ. Думаю, читателю не составит 
труда самостоятельно выделить необходимые данные, а также проверить 
остальные команды РОР3З. 


22.3. Использование сетевых функций 


В завершение темы программирования сетей в операционных системах 
УИпдо\5 поговорим о еще нескольких полезных возможностях. Прежде всего, 
я хочу познакомить читателей с тем, как можно определить 1Р-адрес серве- 
ра программным путем, зная только имя хоста (например, зп\р.уапдех.ги). 
Для этого можно применить функцию изААзупсбеЕНоз«ВуМаме. Она считыва- 
ет указатель на структуру возбепе, содержащую информацию о сервере: 
1Р-адрес, официальное и альтернативные имена и тип возвращаемого адре- 
са. Кроме того, функция возвращает дескриптор операции, с помощью 
которого можно отменить запрос (функция я5АСапсе1АзупсВечиаез®). Чтобы 
лучше понять, как все это работает, посмотрите листинг 22.3. 





Листинг 22.3 Определение П1Р-адреса сервера 





Н1остаае "зеаа#х.В" 

#1ос1аае <озосКк.В> 

// определяем собственное сообщение 
#Чеё1пе М$с_ЗЕВУЕВ _ТМРО ИМ ОЗЕВ + 7000 
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// определяем переменные 

ЗОСКЕТ зоск_эаЕр = МИШ,; // дескриптор сокета 

зЕгисЕ зоска@аг 1п аЧЯгезз; // адресная структура 

позфепЕ* 1пЕо зегуег = МОШ;; // информация о сервере 

СПаг* ТР зегуег = МОГЬ; // указатель на адрес сервера 

сВаг БаЁЕХег[150]; // имя хоста 

сваг з=5егуегТаРо [МАХСЕТНОЗТЕТВОСТ] ; 

// главная оконная функция ( в данном случае для диалога) 

ВООТ САШ.ВАСК Епа1101а1о3ч ( НММО №019, ОТМТ пизда, МРАВАМ мРагам, 
ТРАКАМ 1Рагам) 


зм1Еср ( пз9) // обрабатываем сообщения 

{ 

сазе ММ ТМТТРОТАГОС: // инициализация диалога 

{ 

// инициализируем библиотеку сокетов 
Ти1Ебоскее (1, 1); 
// создаем сокет 
зоск_зтер = зоскеЕ ( АЕ ТМЕТ, 5ОСК_5ТВЕАМ, ТРРВОТО ТСР); 
// считываем из окна редактирования имя хоста 
Сеер1аТеешТехе ( №019, ТОС МУЕОТТВОХ, раЕЕег, 150); 


// делаем асинхронный запрос серверу и регистрируем сообщение 


УЗААз упсбесНозЕВуМате ( №019, М5С _ЗЕВУЕВ_ТМРО, БаЕЁЕек, 
з2бегуегТоЕо, МАХСЕТНОЗТЭТВОСТ); 
} 
гебаги Егие; 
сазе М$С_ ЗЕВУЕВ_ТМРО: // получаем сообщение от сервера 
( 
1Е ( НТМОВО ( 1Рагам) !=0) гебаго 1; // ошибка 
// заполняем адресную структуру 
аЧ99гезз .з1п_ЁЕаш11у = АЕ ТМЕТ; 
а99гезз.з1п_роге = Пбопз ( 25); // номер канала для $МТР 
// сохраняем полученную информацию о сервере 
17Ео_зегуег = { Возфепе*) &57бегуегТаЕо; 
// копируем адрес сервера 
пепиоуе ( &ТР зегуег, 1пЁо зекуег->В а@аг 115%, 
312еоЕ ( сваг*)); 
// записываем адрес сервера в адресную структуру 
шегиоуе ( &а@Чгез5.51п ааг.з_а Аг, &1ТР_зегуег, 
312еоЕ ( сваг*)); 





// устанавливаем соединение с удаленным сервером 
соппесЕ ( зоск_этёр, ( 5ЕгасЕ зоскаЧаг*) баЧагез$, 
$12е0Ё ( зосКаааг 1п)); 
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// посылаем письмо на сервер 


// 


ргеак; 

сазе ТОСАМСЕГ: // закрываем диалоговое окно 
с1озезоскеЕ ( зоск зпЕр); // закрываем сокет 
\ЗАС1еапир (); // выгружаем библиотеку сокетов 
Ера01а1оч ( №019, мРагкам); 
гесаги сгае; 

} 


гебогп Еа15е; 


Как видно из примера, мы использовали функцию ИЗААзупсбеснозЕВуМаме 
для регистрации сообщения и получения информации о сервере. Поскольку 
функция работает в асинхронном режиме, она сразу возвращает управление 
программе. Когда запрашиваемая информация подготовлена сервером для 
передачи, программе посылается наше зарегистрированное ранее сообще- 
ние. При этом значение „Рагам принимает дескриптор выполняемой опера- 
ЦИИ, а 1Рагам содержит следующие значения: старшая 16-разрядная часть — 
код ошибки, младшая 16-разрядная часть — требуемый размер буфера для 
возвращаемых данных. Носле этого остается только обработать буфер 
з;=бегуегтаРо и выделить адрес удаленного сервера. Далее применяем полу- 
ченный адрес для установки связи с сервером и отправки почтового сооб- 
щения. 


А теперь поговорим о том, как можно проверить занятость того или иного 
порта для протоколов ТСР и ЦОР (Ц5ег Оаартат Ргоосо]). Необходимость 
в этом может возникнуть не только в случае банального отправления почто- 
вого сообщения, но и для мониторинга сетевой активности, а также защиты 
компьютера от нежелательного доступа (или вирусов). Примеры реализации 
функций, проверяющих порты на локальном компьютере, представлены в 
листинге 22.4. 





Листинг 22.4. Проверка занятости сетевого порта 


$1ос1а4е "зЕдаЁх.В" 

#1пс1аае <и1тозоск.Н> 

// определяем функции 

11 ТзВизуТСРрогЕ ( ипз1дпеЯ звогЕ рог®); 
116 ТзВазуООРрогЕ ( ипз1дпеЯ зрогЕ рог®); 
// пишем реализацию 

106 ТзВизуТСРроге {( ипз1дпе зВогЕ рог®) 


} 
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// проверяем корректность номера порта 
1Е ( рогё > 65535) гебагп -1; 
// инициализируем библиотеку сокетов 
1Е ( 'Тоебоскее (1, 1)) гебага -2; 
// объявляем переменные 
ЗОСКЕТ зоск рогЕ = МОШ.; // дескриптор сокета 
ЗЕгисЕ зоскаЧаг 1п аЧАгезз; // адресная структура 
// создаем новый сокет ТСР 
зоск_роге = зоскее ( АЕ ТМЕТ, 5ОСК $ТВЕАМ, 0); 
// если ошибка, выходим из функции 
1Е ( зоск_рогЕ == ТМУАБТО 5ОСКЕТ) 
{ 
ИЗАС1еапир (); // выгружаем библиотеку сокетов 
гебаги -3; // выходим из функции 
} 
// заполняем адресную структуру 
аЧ99гезз.з1п_Рап11у = АЕ _ТМЕТ; 
ааЧгезз.з1п роге = Пбопз( рогЕ); // номер тестируемого порта 
// адрес локального сервера по умолчанию 
а@агез5.51п_аЧг.з_аЧАаг = 1щеЕ ааак ( "127.0.0.1"); 
// проверяем доступность указанного порта 
1Е ( соппесе ( зоск роге, ( зегасЕе зоска@аг*) баЧагезз$, 
312е0Е ( зоскаааг 1п)}) 


сфозезоскее ( зоск рог®); 
УЗАС1еапир (); 
гебагп 1; // порт занят или произошла ошибка 
} 
// закрываем сокет и выгружаем библиотеку из памяти 
с1озезоскее ( зоск роге); 
М5АС]еапир (); 


хебогп 0; // порт не занят 


1пе ТзВазу0ООРроге ( цпз1дтеа зрокЕ рог®) 


{ 


// проверяем корректность номера порта 

1Е { рокЕ > 65535) гебакп -1; 

// инициализируем библиотеку сокетов 

1ЁЕ ( !ТотЕЗоскее (1, 1)) гебакп -2; 

// объявляем переменные 

ЗОСКЕТ зоск рогЕ = МО; // дескриптор сокета 
ЗЕгисЕ зоска@Чг 1п аЧагезз; // адресная структура 
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// создаем новый сокет ОПОР 
зоск_рог® = зоскее ( АЕ ТМЕТ, $ОСК ОСВАМ, 0); 
// если ошибка, выходим из функции 
1Е ( зоск рогЕ == ТМУАЬТО 5ОСКЕТ) 
{ 
ИЗАС1еапир (); // выгружаем библиотеку сокетов 
гесагп -3; // выходим из функции 
} 
// заполняем адресную структуру 
аЯагез$.31п_Ёаш11у = АЕ ТМЕТ; 
а99гезз.з1п рогЕ = Вбопз( рог); // номер тестируемого порта 
// адрес локального сервера по умолчанию 
ааа9гезз.51п аааг.з аЧахг = 1пеё аЧахг ( "127.0.0.1"); 
// проверяем доступность указанного порта 
3Е ( Б2та ( зоск рогЕ, ( зекасЕ зоскадаг*) за@@гезз, 
312ео0Ё ( зоска@аг 1п))) 


с1о5езоскее ( зоск_рогЕ); 
ИЗАС1еапир (); 
гесагп 1; // порт занят или произошла ошибка 
} 
// закрываем сокет и выгружаем библиотеку из памяти 
с1озезоскее ( зоск_рог®); 
ИЗАС1еапар (); 
тесагп 0; // порт не занят 


Как вы, наверное, заметили, обе функции проверки порта очень похожи. 
Вначале мы проверяем, корректно ли задан номер тестируемого порта. Свя- 
зано это с тем, что протоколы ТСР и ЧШР поддерживают до 65 535 портов. 
Все номера портов распределены следующим образом: от 0 до 1023 для 
стандартных служб, от 1 024 до 49 151 для заказных портов, 49 152—65 535 
для частных и динамически распределяемых портов. Назначение некоторых 
часто используемых портов ТСР показано в табл. 22.4. 


Таблица 22.4. Назначение стандартных портов 


Номер 

порта Назначение 
7 ЕСНО (тестирование сервера) 
11 ОЗЕВ$ (активные пользователи} 


19 СНАЯСЕМ (генератор символов) 
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Таблица 22.4 (окончание) 


ры Назначение 
20 Протокол ЕТР (данные по умолчанию) 
21 Протокол ЕТР (управление) 
23 Протокол ТЕЕМЕТ 
25 Протокол ЗМТР 
53 ООМА!М (служба доменных имен) 
110 Протокол РОРЗ 
119 Протокол ММТР (Мезмогк Ме\муз Тгапз{ег Рго{осо) 
123 Протокол МТР (Мемогк Тите Ргоюсо!) 
143 Протокол 1МАР (1щепт Май Ассезз Рго{юсо|) 
161 Протокол ЗММР (Зитре Ме\муогк Мападетег Ргоосо!) 
563 Протокол ММТР с ЗЕ 
993 Протокол МАР с 55 
995 Протокол РОРЗ с ЗЕ 


После проверки номера порта инициализируем библиотеку сокетов, вызы- 
вая функцию Тое5оскее. Далее создаем новый канал связи (50Ск 5ТВЕАМ — 
ТСР, зоск рсвАМм — ЦОР) и пытаемся его открыть (назначить для СОР). Ес- 
ли функция соппесе (5:па для ООР) возвращает нулевое значение, ошибок 
нет и указанный порт свободен, а поскольку нам требовалось лишь прове- 
рить состояние порта, закрываем его с помошью Функции слозезоскее. 
Единственный момент, который мне хотелось бы уточнить, связан с указа- 
нием [Р-адреса. В обоих случаях был задан стандартный локальный адрес 
127.0.0.1, поскольку он является жестко фиксированным и предназначен 
для тестирования различных сетевых служб без установки соединения с 
сетью. Кроме того, он позволяет отлаживать различные сетевые компонен- 
ты и программы, заменяя реальный адрес сетевого сервера. 


И напоследок, расскажу о том, как послать сообщение через популярную во 
всем мире службу ГСО. Прежде всего, нам понадобится адрес сайта (на 
данный момент это \е4с4.сош) и порт ТСР под номером 80. Уникальный 
номер (идентификатор) пользователя службы 1СО следует узнать у того, ко- 
му вы будете передавать сообщение. Пример функции, реализующий от- 
правку письма через [СО, показан в листинге 22.5. 
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: Листинг 22.5. Передача сообщения через службу 1С@ 


#1пс1аае "зЕЧаЁх.В" 

ф1ос1аае <из1озоск.В> 

// определяем функцию 

1п1е ТзВизуТСРрогЕ ( ипз1дпеЯ зВог®е рог®); 

// пишем реализацию 

Роо1 Зерпа ТСО Меззаде ( спаг* 14а, спаг* паше, сваг* е па11, 
сраг* заб]есёе, сваг* 15а) 


// объявляем переменные 

ЗОСКЕТ зоск_1са = МОШЬ; // дескриптор сокета 

зЕгисе зоскаЧаг 1п а@агез$; // адресная структура 

Возкере* зто 1са = МО; // информация о сервере 

СПаг* р = МОШ,; // указатель на буфер данных 

106 БаЕ 1еп = 0; // размер буфера данных 

// обнуляем структуру зоскадаг 1п 

пепзее ( бзаЯагезз, 0, $1хе0+ ( зоскаааг 1п)); 

// вычисляем размер буфера данных 

РаЕ 1еп = з6г1еп ( 149) + зЕг1еп ( папе) + эег1еп ( е та11) + 
зег1еп ( зоб)ес®) + зЕх1еп ( пза) + 100; 

// выделяем память под буфер 

р = пем сВаг [РаЁ 1еп]; 

ЗЕ (р == МОШ.) гебаго Еа1зе; 


// инициализируем библиотеку сокетов 

1Е ( !Шп16боскее (1, 1)) 

{ 
1Е (р) делеке [] р; // освобождаем память 
герагп Еа15е; 

} 

// определяем ТР-адрес сервера службы ТСО 

по _1са = декпоз®Бупаме ( "мер.1са.сом"); 

// проверяем результат 

ЗЕ ( !10Ео_1са) 

{ 
ИЗАС1еапиар (); 
1Е (р) Чде1есе [] р; // освобождаем память 
гекагп Ёа1зе; // выходим из функции с ошибкой 

} 

// создаем новый канал связи 

зоск_1са = зоскеЕе ( АЕ ТМЕТ, 5ОСК ЗТВЕАМ, ТРРВОТО ТР); 
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// если канал не создан, выходим из функции 
1Е ( зоск 1са == ТМУАБТО $ОСКЕТ) 
{ 
1Е (р) Че1еее [] р; // освобождаем память 
ИЗАС1еапир (); 
тебагп Еа15е; 
} 
// заполняем адресную структуру 
аЯагезз.51п_Ёат11у = АЕ ТМЕТ; 
аЧЧгезз.51п роге = Беопз( 80); // номер порта 
аЯагезз.51п_аЧЧг = *( 1п а@аг*) Воз&->Н_ а@Чг; // адрес сервера 
// устанавливаем соединение с удаленным сервером 
1Е ( соппес®е ( зоск 1са, ( зегасе зоскаЧаг*) вааагезз, 
51 2еоЕ ( зоскаааг 1п))) 


с1озезоскее ( зоск_1са); // закрываем канал связи 
\ЗАС1еапир (); 
1Е (р) Че1есе [] р; // освобождаем память 
гегигп Ёа1зе; // выходим из функции с ошибкой 
} 
// формируем сообщение 
зЕгсру (р, "СЕТ /зст1рез/МИРМза.911?"); // копируем имя скрипта 
эегсае р, "Егопе"); 
зЕгсаф ( р, паме); // добавляем имя отправителя сообщения 
зе гсае р, "&Егошета11="); 
эегсае р, е па11); // добавляем адрес почты отправителя сообщения 
зЕгсае р, "&заБ)есе="); 
зе гсае р, заб)ес®); // добавляем название темы сообщения 
зЕгсае р, "&боау="); 
зЕгса® (р, пз9); // добавляем текст сообщения 
эзеусаб( р, "&бо="); 
зе гсае р, 19а); // добавляем идентификатор получателя 
зЕгсае( р, " НТТР/1.0\х\п"); // добавляем завершающую строку 
// отправляем сообщение на сервер 
зеги' ( зоск_1са, р, РаЕ 1еп, 0); 
// проверяем результат операции 
гесу ( зоск 1са, р, БаЁ 1еп, 0); 





// выводим на консоль отладчика 
ОисриЕВеро95ег119 ( збабаз); 

// закрываем канал связи 

с1озезоскее ( зоск_1са); 

МЗАС1еапир (); // выгружаем библиотеку сокетов 
1Е (р) ае1еёе [] р; // освобождаем память 


} 
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гесагпр ©гае; // выходим из функции 


// пример использования функции Зепа ТСО Меззаде 


СсВаг* сехе = "Нео Ёгзеп@"; // текст сообщения 

// вызываем функцию 

Зепа ТСО Меззаде ( "2534888", "Туап", "1уап@Во®ла11.сом", "Рг1уес", 
техе); 


Итак, чтобы послать сообщение, мы выполнили следующие действия: 


Инициализировали библиотеку сокетов с помощью функции тп1ебоскее. 


| 
2. Определили 1Р-адрес удаленного сервера через функцию деспоз®Ъупапе. 
3. 
4 
5 


Создали новый канал связи по протоколу ТСР (функция зоске\). 


. Установили связь с удаленным сервером посредством соппесе. 


. Сформировали и передали сообщение пользователю службы 1СО. 


Кроме того, для наглядности мы распечатали информацию, полученную от 
сервера в окне отладчика, применив для этого функцию оперисреьаа тд. 
И хотя функция зепа_тСо Меззаде получилась немного громоздкой, но зато 
она позволяет легко корректировать основные параметры сообщения. 


ГЛАВА 23 


Трюки и секреты 


В этой главе я собрал разнообразные полезные мелочи, которые, надеюсь, 
будут очень кстати начинающим и опытным программистам, работающим 
в \ш4о\5. Поскольку рассматриваемые здесь темы узки и разноплановы, 
их не удалось озвучить в предыдущих главах, но их невероятная привлека- 
тельность все же не позволила полностью от них отказаться. Каждая из 
представленных ниже тем абсолютно независима, поэтому читатель может 
сразу переходить к наиболее интересному для него разделу. 


23.1. Определение 
параметров оборудования 


Здесь мы поговорим об одной хитрой возможности, позволяющей достаточ- 
но легко получить конфигурационные параметры установленного в системе 
оборудования. К таким параметрам относятся, в первую очередь, номера 
портов ввода-вывода, выделенные прерывания и адреса в памяти. Все, что 
нам требуется, — это написать несколько функций для доступа к системно- 
му реестру. Именно там, в удобной, но несколько запутанной форме распо- 
ложены все основные сведения о компьютере. Увидеть эти данные можно 
как с помощью диспетчера оборудования, так и при непосредственном про- 
смотре файла реестра. 

Сразу замечу, что размещение данных в реестре (пути), описывающих 
имеющиеся устройства, отличается для профессиональных систем \У/т- 
4о\$ МТ/2000/ХР/5ВЗ. Кроме того, доступ к реестру в профессиональных 
системах организовать несколько сложнее, чем в пользовательских системах 
\УМта4о\з 9х/МЕ. 


Данные о конфигурации оборудования находятся в следующих разде- 
лах реестра: НКЕУ_РУМ_РАТА\Сопй? Мапарег\Епит для \Мт4о\$ 9х/МЕ и 
НКЕУ_ГОСАГ_МАСНПУЕ\ЗУЗТЕМ\ СштгетСопего Зе \Епит для У - 
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4о\5 МТ/2000/ХР/$КЗ. В подразделе Епшт перечислены все доступные сис- 
теме устройства и их основные параметры. В первую очередь, нас интере- 
суют расположение устройства (параметр Нагд\/агеКеу) и выделенные сис- 
темой ресурсы (параметр АЙосайоп). С помощью значения Нагд\У/агеКеу мы 
определим имя и класс устройства, а двоичный массив АЦосайоп поможет 
вычислить порты ввода-вывода, адреса памяти, каналы КО и ОМА. Ос- 
тальные параметры в данном случае не имеют значения. 


Итак, напишем функцию, которая сканирует реестр в поисках информации 
об установленном оборудовании для \та4о\з 9х/МЕ. Пример такой функ- 
ции показан в листинге 23.1. 





Листинг 23.1. Определение основных параметров устройств в МИАпаом$ 9х/МЕ 
#1ос1аде "зЕдаЁх.В" 
// определяем макросы 
// раздел реестра НКЕУ_РУМ_ РАТА 
#ЧеЕ1пе НКРБ_ЕМОМ "СопЕ19 Мападег\\Епим" 
#АеЕ1пе НКТМ ЕМОМ "Епим\\" // раздел реестра НКЕУ ТОСАЬ МАСНТМЕ 
#ЧеЁ1пе МАХ РЕУТСЕЗ 200 // возможное количество устройств в системе 
// перечисляем основные типы данных 
епим РасаТурез9х 
{ 
Мепогу Туре 9х = 0х00000001, // адрес в памяти 
Роге Туре 9х = 0х00000002, // адрес порта ввода-вывода 
ОМА Туре 9х = 0х00000003, // номер канала ОМА 
ТВО Туре_9х = 0х00000004 // номер прерывания 
}; 
// определяем структуры для описания данных 
СуредеЕ зегасЕ _Мепогу9х // обработка адресов 
{ 
РМОВР сЪ512е; // размер данных 
РМОВР амТуре; // тип данных 
ОМОВР Везегуей; // не используется 
1оп9 116 Вазе Мепогу; // базовый адрес 
1019 11 ЕрЯ Метшогу; // завершающий адрес 
РИОВО Везегуе42; // не используется 
1019 116 А119п Метогу; // выравнивание данных 
1009 106 СоирЕВубез; // количество выделенных байтов в памяти 
1009 10 М1пАааггез; // минимальное значение адреса 
1019 30 МахАЧагтез; // максимальное значение адреса 
РИОВР ВезегуеЯ3; // не используется 
} МЕМОВУЭХ, *РМЕМОВУЭХ; 
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// структура для хранения портов ввода-вывода 
фуредеЕ зегасе _Рог& 9х 
{ 
ОМОВЬ сЪ512е; // размер данных 
ОМЮКО ЧмТуре; // тип данных 
ОМОВО ВезегуеЯ; // не используется 
МОВО Вазе_Роге; // адрес базового порта 
МОВО Епа Роге; // адрес последнего порта 
ОМОВО ВезегуеЯ2; // не используется 
МОВО ТОВ_А119п; // выравнивание данных 
МОВО СобпЕРоге5; // количество портов 
ИОВО ТОВ_М1п; // минимальный адрес порта 
. №ОВО ТОВ_Мах; // максимальный адрес порта 
РИОВР ВезегуеЯ3; // не используется 
} РОВТ9Х, *РРОВТУХ; 
// структура для хранения канала ОМА 
фуредеЕ зегасЕе _ПМАЭХ 
{ 
ОИОВО сЪ$12е; // размер данных 
ОМОВО ЧмТуре; // тип данных 
ВУТЕ ВезегуеЧ; // не используется 
ВУТЕ Сваппе1; // номер канала ОМА 
МОВО Везегуе42; // не используется 
} ОМАЭХ, *РОМАЭХ; 
// структура для хранения номера прерывания 
фуредеЕ зЕгасе _ТВО9Х 
{ 
ОМОВО сЪ312е; // размер данных 
ОМЮВО ЧмТуре; // тип данных 
МОВО ВезегуеЯ; // не используется 
МОВО Мипфег; // номер прерывания 
ОИОВО Везегуе42; // не используется 
} ТВО9Х, *РТВО9Х; 
// структура для хранения имени и класса устройства 
фуредеЕ зЕгасе _Реу1сеРагатмз9х 
{ 
сваг НагЯМагеКеу[МАХ_РАТН]; // путь к устройству в реестре 
сваг Оеу1серезс [150]; // название устройства 
сваг С1азз[50]; // класса устройства 
ОМОВО Вазе_Мепюгу[16]; // базовые адреса в памяти 
ГИОВО Епа Метогу[16]; // завершающие адреса в памяти 
МОВО Вазе_Рог&[16]; // адреса базовых портов ввода-вывода 
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ИОВО Епа РогЕ[16]; // номера завершающих портов ввода-вывода 
ВУТЕ РМА СПаппе1[8]; // номера выделенных каналов ОМА 
ВУТЕ ТВО Моифег[16]; // номера выделенных прерываний 
} ПЕУТСЕРАВАМ$9Х, *РРЕУТСЕРАВАМ$9Х; 
// определяем функцию поиска устройств в реестре 
у01А Себреу1сезСопЕ19_9Х (); 
// массив структур РЕУТСЕРАВАМ$ 9Х для описания устройств 
РЕУТСЕРАВАМ$ 9Х Чеу1сез [МАХ _РЕУТСЕ$]; 
// реализация функции 
у01А береу1сезСопЕ19_Э9Х () 
{ 
НКЕУ рЮКеу = МОБ, рЬКеу2 = МОШ.; // дескрипторы разделов реестра 
ОМОВР амКеу = 0; // счетчик разделов реестра 
ОМОВО 9м5312е = 0; // размер значения параметра реестра 
РИОВР @мТуреРагамеег = ВЕС 52; // тип параметра реестра 
сваг зес®1оп_паме[МАХ_РАТН]; // имя найденного раздела 
сраг пем рав [МАХ_РАТН]; // полный путь к разделу 
СсБаг Вага Кеу[150]; // описание параметра 
116 1 = 0; // счетчик циклов 
ВУТЕ БуВаЁЁЕекг [300]; // буфер для данных 
// счетчики для определенных типов данных 
ип519пеЯ 116 оМетогу 1п4ех = 0, чРогЕ 1п4ех = 0, орМА 1таех = 0, 
ЦТВО 1паех = 0; 
МЕМОВУЭХ Еетр9х; // временный буфер для форматированных данных 
// структуры для хранения определенных данных 
МЕМОВУ9Х петогу9х; 
РОВТУХ рогё9х; 
ОМАЗХ дта9х; 
ТВО9Х 1га9х; 
// обнуляем структуры 


РегоМецщогу ( &тецогу9х, з1теоЕ ( МЕМОВУЭХ)); 
2егоМецогу ( &рог®9х, э1теоЕ ( РОВТЭХ)); 
легомемогу ( &Чма9х, з1теоЕ ( РМАЭХ)); 
7егоМепоку ( &1ка9х, з1хеоЕЁ ( ТВО9Х)); 


// обнуляем главную структуру данных 
Бог (1=0; 1 < МАХ РЕУТСЕ$; 1++) 
2егоМметогу ( 54еу1сез[1], з12хеоЕ ( РЕУТСЕРАВАМ$9Х)); 
// открываем раздел реестра "НКЕУ РУМ ОАТА\СопЁ19 Мападек\Епим" 
1Е( '!ВедОрепкеуЕх ( НКЕУ РУМ_РАТА, НКРЬ_ЕМОМ, 0, КЕУ ВЕАО, &рьКеу) 
== ЕВВОВ_50ССЕЗ$) 
гефагп; // выходим из функции в случае ошибки 
м211е (1) // обрабатываем все найденные подразделы 
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{ 
// получаем очередное имя подраздела 
1Е ( ВедЕпалКеу ( рЮКеу, @мКеу, зес®1оп паше, МАХ РАТН) 
== ЕВВОВ МО МОВЕ ТТЕМЗ) 
ЬгеаК; // если все подразделы найдены, завершаем цикл 
// собираем полный путь к найденному подразделу 
зегсру ( пем рабп, НКРР ЕМОМ); 
зЕгсаЕ ( пем рав, "\\"); 
зЕгсаЕ ( пем рабп, зесе1оп папе); 
// открываем подраздел 
1+ ( ВедОрепКеуЕх ( НКЕУ РУМ РАТА, пем рабН, 0, КЕУ ОЦЕВУ УАБОЕ, 
&рИКеу2) == ЕВВОВ_$0ССЕЗ5) 


// предварительно определяем размер возвращаемых данных 
1Е ( Ведбцекууа]аеЕх ( рЬКеу2, "НахгаМагекеу", МОШЬ, 
5@иТурерРагацекг, МОЪЬ, &9м512е) == ЕВВКОВ_$0ССЕ$5) 


// получаем путь к устройству 
ВедОцегуУа1аеЕх ( рПКеу2, "НагОМагеКеу", МОБЬЬ, МОШЬ, 
( ГРВУТЕ) Вага Кеу, &9м51те); 
// сохраняем полученное значение 
зЕгсру ( Чеу1сез [@мКеу] .НагОМагекКеу, Прага Кеу); 
} 
// определяем размер следующего значения 
3Е ( Веабчегуу\а1аеЕх ( рЬКеу2, "АШосае1оп", МОШ, 
5иТурерРагацесг, МОШ., &9м512е) == ЕВВОК_5ОССЕЗ$5) 


// получаем параметры устройства 
ВедОцегу\У\а1аеЕх ( рЮКеу2, "А11осазоп", МОЬЬ, МОЦ, 
( ГРВУТЕ) БуВаЕЕег, &9м512е); 
// восстанавливаем и форматируем данные 
пе 1лаех = 8; 
2егоМетогу ( &бепр9х, з1теоЁ ( МЕМОВУУХ)); 
// анализируем данные и выделяем нужное 
мр11е ( БуВоЕЕек [1п4ех] > 0) 
{ 
// помещаем данные в структуру 
пепиохуе ( ( %014*) &сетр9х, &БуВаЕЕег[1паех], 8); 
// выделяем тип данных 
зм1Еср ( Еетр9х.амТуре) 
{ 
сазе Метмогу Туре 9х: // адреса в памяти 
1Е ( оМепвогу 1п4ех < 16) 
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// помещаем данные о памяти в структуру 
пештоуе ( ( \%0149*) блетогу9х, &руВиЕЕехг [1п4ех], 
51хеоЁ ( МЕМОВУЭХ)); 
// сохраняем базовый адрес 
Че\у1сез[9мКеу].Вазе_Мепогу [аМетогу 1п9ех] = 
петогу9х.Вазе_Метогу; 
// сохраняем завершающий адрес 
Че\у1сез [ЭмКеу] .Епа_Метогу [аМетогу 1п4ех] = 
петогу9х.Епа Мепогу; 
Мепогу 1п4ех++; // увеличиваем счетчик 
// обнуляем структуру 
РегоМетогу ( бметогу9х, $12еоЕЁ ( МЕМОВУЭХ)); 
} 
ргеак; 
сазе Роге Туре_9х: // адреса портов ввода-вывода 
{ 
пептоуе ( ( %о1а*) &рогЕ9х, &руВоЕЕег [1паех], 
512еоЁ ( РОВТЭХ)); 
Че\1сез [9иКеу] .Вазе Рог® [аРогЕ_1п4ех] = 
рох®9х.Вазе_ Роге; 
де\1сез [ЧмКеу] .Епа Рок [аРоге 1п4ех] = рогЕ9х.ЕпЯ РогЕ; 
уРогЕ 1п4ех++; 
7егоМетогу ( &рогЕ9х, з1хеоЕЁ ( РОВКТЭХ)); 
} 
Ьгеак; 
сазе ОМА Туре 9х: // каналы прямого доступа к памяти 
{ 
тетииоте ( ( %01а*) &дта9х, &руВоЕЕег [1п4ех], 
$12еоЕ ( ПМАЭХ)); 
Че\у1сез [9\Кеу] .ОМА_Спаппе1 [аОМА 1п4ех] = дта9х.Спаппе1; 
ОМА 1п4ех++; 
7егоМетогу ( &дта9х, з1хеоЕЁ ( ПМАЭХ)); 
} 
Ьгеак; 
сазе ТВО Туре 9х: // номер прерывания 
{ 
пепто\уе ( ( 014%) &1га9х, &руВаЕЕег [1п4ех], 
$12еоЕ ( ТВОЭХ)); 
еу1сез [9мКеу] .ТВО №лиюег [ОТО 1п4ех] = 1га9х.Маюрег; 
у1ВО_1п9ех++; 
7егоМетогу ( &1ка9х, з12еоЕ ( Т1ВО9Х)); 
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} 


Огеак; 
} 
// увеличиваем смещение в буфере данных 
1п4ех = 1п9дех + фепр9х.сЬ512е; 
} 
} 
// закрываем подраздел 
1Е ( рЬКеу2) ВедС1озеКеу ( рЮКеу2); 
} 
е15е 
{ 
// если не удалось открыть подраздел, переходим к следующему 
соп1пае; 
} 
// увеличиваем счетчик разделов 
@ЧмКеу++; 
// обнуляем счетчики 
Метогу_1пдех = 0; 
Роге 1п9дех = 0; 
аРМА_1пдех = 0; 
УТВО 1п4ех = 0; 


// закрываем корневой раздел 

1Е ( рыКеу) ВедС1озеКеу ( рЮКеу); 

Р—Кеу = МОШ; 

1=0; 

// получаем описание найденного устройства 
Бог (1; 1 < ЧмКеу; 1++) 


{ 


// собираем путь к устройству 
з&гсру ( пем рафй, НКИМ ЕМОМ); 
эсгса® ( пем рафВ, Чеу1сез[1].НагОМагеКеу); 
// открываем подраздел 
1Е ( ВедОрепКеуЕх { НКЕУ ГОСАГ МАСНТМЕ, пем ра®п, 0, 
КЕУ ОЦЕВУ УАБОЕ, &рЬКеу) == ЕВВОВ_З0ССЕЗ$) 


// определяем размер значения параметра 
1Е ( ВедОдегуУа1лаеЕх ( рЬКеу, "ШБеу1сеПезс", МОШЬ, &диТуреРагапме%г, 
МОБ, &9м51хе) == ЕВВОВ_50ССЕЗ$$) 


// получаем значение параметра 
ВедОдегуУа1аеЕх ( рИКеу, "Беу1серезс", МОБ, МОЦ, 
( ГРВУТЕ) ВагЯ кеу, &9м51хе); 
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// сохраняем в основной структуре 

$Егсру ( Чеу1сез[1].Беу1сепезс, Вага _кКеу); 
} 
// закрываем подраздел 
1Е ( рЬКеу) ВедС1озеКеу ( рЬКеу); 


} 
// определяем имя класса для найденных устройств 
ог (1=0; 1 < Амкеу; 1++) 
{ 
// собираем путь к устройству 
5Егсру ( пем раёр, НКЫМ ЕМОМ); 
з&гса* ( пем раёП, аеу1сез[1].НагаМагекеу); 
// открываем подраздел 
1Е (ВедОрепКеуЕх ( НКЕУ БОСАБЬ МАСНТМЕ, пем раб, 0, КЕУ ОЧЕВУ УАБОЕ, 
&рЬКеу) == ЕВВОВ_З0ССЕЗЗ) 


// определяем размер значения параметра 
1Е ( ВедОпегуУа1аеЕх ( рЬКеу, "С1а55", МОГ, &амТуреРагапе*т, 
МОГТ, &4м$12е) == ЕВВОК_ $0ССЕ55$) 


ВедОпегуУа]аеЕх ( рИКеу, "С1азз", МОБ, МОБ, 
( ГРВУТЕ) Вага Кеу, &Ч9м512е); 
$&гсру ( Чеу1сез[1].С1аз5, пака кеу); 
} 
1Е ( рИКеу) ВедС1озеКеу ( рЮКеу); 


Для обработки данных были созданы пять специальных структур, четыре из 
которых хранят определенный тип данных, а последняя связывает все полу- 
ченные данные в общий блок описателя устройства. После этого с помощью 
функции  ВедОрепКеукх открыли раздел реестра НКЕУ_ПУМ_ОАТА 
\Сопй? Мапагег\ Епит. Данный раздел является динамическим, т. е. созда- 
ется заново при каждом запуске операционной системы, поэтому не стоит 
полагаться на случай и сохранять текущую конфигурацию оборудования в 
файл или куда-то еще. Правильнее будет перед обращением к оборудова- 
нию повторно вызывать функцию сеереу1сезСопЕ1а_9х. После успешного 
открытия раздела с помощью функции ВедЕпожКеу получаем все имена под- 
разделов. В качестве счетчика эта функция использует переменную амКеу, 
возвращая при каждом обращении новое значение. Когда все имена подраз- 
делов переданы, функция завершается с кодом еЕВВОВ_МО МОВЕ ТТЕМ$. В от- 
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крытом подразделе получаем значение параметра Нагд\УагеКеу и сохраняем 
его в структуру РЕУТСЕРАВАМ$. Этот параметр содержит определенный путь в 
реестре, и его значение понадобится нам позже для определения класса и 
типа устройства. Далее с помощью Функции Ведочегууа1аеЕх считываем 
значение двоичного параметра АПосайопт (для получения сразу нескольких 
значений рекомендуется использовать функцию ведблегуМа1&1{р1еуа1аез). 
Этот параметр позволяет получить основные характеристики устройства: 
адреса доступа в памяти и адреса ввода-вывода, номер прерывания и канал 
ОМА. И в завершение, восстанавливаем имя класса и тип для каждого най- 
денного устройства. 


А теперь рассмотрим, как аналогичную задачу можно решить в профессио- 
нальных системах \Итдо\$ МТ/2000/ХР/ЗВЗ. Здесь, как я уже говорил, код 
будет несколько сложнее и запутаннее. Пример функции, определяющей 
доступные устройства, показан в листинге 23.2. 






: в ММпаом$ МТ/2000/ХР/5 КЗ 





$1пс1о4е "5ЕдаЁх.В" 
// путь к разделу в реестре, описывающему установленное оборудование 
‚ #ЧеЕ1пе НКЫМ ЕМОМ МТ  "5У5ТЕМ\ \СаггепЕСопего15е< \\Епим” 
#$АеЕ1пе МАХ РЕУТСЕ$ 200 // возможное количество устройств в системе 
// дополнительные флаги 
#$АеЕ1пе РОВТ МЕМОВУ 0х0000 // адрес порта в памяти 
#ЧеЕ1пе РОВТ_ТО 0х0001 // адрес порта ввода-вывода 
#ЧеЕ1пе МЕМОВУ ВЕАР ИВТТЕ 0х0000 // память для записи и чтения 
#аеЕ1пе МЕМОКУ ВЕАР ОМГУ 0х0001 // память только для чтения 
$АеЕ1те МЕМОВУ ИКТТЕ ОМГУ 0х0002 // память только для записи 
// тип канала ОМА 
$АеЕ1те РМА_8 0х0000 
#+ЧеЕ1пе ПОМА_16 0х0001 
#ЧеЕ1пе ПОМА_32 0х0002 
// типы данных 
епим РатаТурезМТ 
{ 
Рог*_Туре = 1, // адрес порта ввода-вывода 
ТВО Туре = 2, // номер прерывания 
Метогу Туре = 3, // адрес в памяти 
ОМА Туре = 4, // номер канала ОМА 
ВазМ№алрег Туре = 6 // номер шины 
}; 
// определяем тип значения для хранения адресов 
ТуредеЕ ТАВСЕ ТМТЕСЕК РНУЗТСАЬ АООВЕЗ$5; 
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// определяем структуры для описания данных 
#ргадта расК ( 4) 
СуредеЕ зегасе _ТОРАТА 
{ 
\11$1дпеЯ свахг Туре; // тип возвращаемых данных 
1$1апеЯ сваг ЗВаге; // общий доступ к данным 
и1519пеа зпогЕ Е1адз; // дополнительный флаг описания 
// общая область памяти 
уатоп 
{ 
5Егасе // обработка портов ввода-вывода 
{ 
РНУЗТСАТ АОРВЕЗ$ Заг®; // базовый адрес 
ип519дтлеЯ 1опд ТепдеВ; // ширина порта 
} РогЕ; 
зЕтасЕ // обработка номера прерывания 
{ 
ип519теЯ 1опд Те\уе1; // уровень доступа 
ип51дпеЯ 1опд Мамюег; // номер выделенного прерывания 
01$191еЯ 1опд ВезегуеЯ; // резерв 
} ТВО; 
5Егисфе // обработка адресов в памяти 
{ 
РНУЗТСАЬ АООВЕЗ$ З6ахе; // базовый адрес 
115$190еЯ 1опд ТепдаЕй; // ширина адресного пространства 
} Мемогу; 
зЕгасе 
{ 
и1$19пеЯ 1опд Спаппе1; // номер выделенного канала ОМА 
\1$1дтеЯ 1опд Роге; // номер порта 
и1$1дпеЯ 1опд ВезегуеЯ; // резерв 
} ОМА; 
ЗЕгисЕ // обработка номера шины 
{ 
ип$1д9теЯ 1опд 5%аг®; // базовый адрес шины 
\11$19пеЯ 1опд ТепаЕей; // ширина адресного пространства 
ипз1дтеЯ 1опд Везегуей; // резерв 
} Ваз№Млирег; 
} и; 
) ТООАТА, *РТОРАТА; 
#ргадта расКк () 
СуреаеЕ эегисе _ОАТА ПТ$Т 
{ 
ип51апеЯ зВогЕ Уегз1оп; // номер версии 
и15191еЯ эпохе Ве\у15101; // дополнительный номер версии 
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\115191еЯ 1опа Соцпе; // полное количество данных об устройстве 
ТОРАТА 1а9[16]; // массив структур для получения данных 
} РАТА_ЪТЗТ, *РРАТА_ПТ$Т; 
ТуредеЕ зфгасе _ПАТА ТТ$5Т_АШ, 
{ 
ОМОВР ВезекуеЯ; // резерв 
\115190еЯ 1опд ВезегуеЯ2; // резерв 
РАТА_ТТ$ЗТ Рафа156; // структура РАТА_1Т5Т 
} РАТА ГТ5Т АБ, *РРАТА ГТ5Т АБ,; 
ТуредеЕ зфгасЕ _РАТА 
{ 
1151а9пеЯ 1опа Соупе; // количество найденных описателей устройства 
РАТА ТТ5Т АГ А11 1356[2]; // массив структур РАТА ГТ5Т_АЫ, 
} РАТА, *РРАТА; 
// основная структура описателя устройства 
ТуредеЕ эЕгисЕ _Пеу1сеРагаиМТ 
{ 
сваг Беу1серезс [100]; // текстовое описание устройства 
сваг Ег1еп91уМаме [80]; // дополнительное описание устройства 
спаг С1аз3[50]; // имя класса устройства 
РНУЗТСАЬ АООВЕЗ$ Вазе Метоху[16]; // базовые адреса в памяти 
РНУЗТСАЬ АШРВЕЗ$ Епа Метогу[16]; // завершающие адреса в памяти 
\11519пе@ зпоге ТуреВазеМепогу[16}; // тип адреса в памяти 
РНУЗТСАЬ АРОВЕЗЗ Вазе Рог [16]; // базовый порт ввода-вывода 
РНУЗТСАЬ АОБВЕЗ$ ЕпЯ_Рог®[16]; // завершающий порт ввода-вывода 
\11519пе@Я зрохгЕ ТуреВазеРог& [16]; // тип порта ввода-вывода 
ВУТЕ ОМА Спаппе1 [8]; // номер выделенного канала ПМА 
п51а1еЯ зногЕ ТуребМА[8]; // тип канала ОМА 
ВУТЕ ТВО №лорег[16]; // номер выделенного прерывания 
\11519пеЯ 1пе ВазМоирег[8]; // номер шины для некоторых типов устройств 
} РЕУТСЕРАВАМЗМТ, *РОЕУТСЕРАВАМЗМТ; 
// определяем функцию поиска устройств в реестре 
у01А беереу1сезСопЕ19 МТ (); 
// массив структур РЕУТСЕРАВАМ$МТ для описания устройств 
РЕУТСЕРАВАМЗМТ деу1сез МТ[МАХ РЕУТСЕ$]; 
// реализация функции 
у01А беереу1сезСорЁ1а_ МТ () 
{ 
// объявляем переменные 
НКЕУ рЮКеу = МОШЬ, рНКеу2 
РЬКеу5 
// счетчики разделов и размеры значений параметров в реестре 
РМОВО @мКеу = 0, 9мКеу2 = 0, 9мКеуЗ = 0, Я9м512е = 0, сЪМаме = 256; 


МИТГТ, рНыКеуЗ = МОШ., рЬКеу4 = МО, 
МОП; // дескрипторы разделов реестра 
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// счетчики данных 


015191е@ 11 чРоге 1п4ех 0, ОТВО 1паех 0, оМетогу 1п4ех = 0, 
ОМА _1п4ех = 0, Виз 1паех = 0; 

// счетчик найденных устройств 

90549 1е@ пе отпаех = 0; 

// различные пути в реестре 

сБаг зес&1оп_ папе [513]; 

спаг пем_раЕП[МАХ_РАТН]; 

сраг пем_ раЕВ2 [МАХ_РАТН]; 

сваг пем ра&В3 [МАХ _РАТН]; 
] 
} 


Й 


сваг пем рае14 [МАХ_РАТН 
спаг пем_раев5 [МАХ_РАТН]; 
// буфер для данных 
спаг Ваг@_кеу[150]; 
// структура для получения данных об устройстве 
РАТА СЁд; 
// обнуляем структуру перед использованием 
Бог (1=0; 1 < 200; 1++) 
2егоМепюгу ( &Чеу1сезМТ[ 1], $з17еоЕЁ ( РЕУТСЕРАВАМЗМТ)); 
// открываем раздел реестра для перечисления подразделов 
1Е ( 'ВедОрерКеуЕх ( НКЕУ ТОСАЬ МАСНТМЕ, НКЦМ ЕМОМ МТ, 0, КЕУ ВЕАО, 
&рИКеу) == ЕВВОВ_$0ССЕЗ$$) 
гебсагп; 
\р11е (1) 
{ 
// определяем размер значения 
сОМаше = 256; 
// перечисляем подразделы в открытом разделе 
1Е ( ВедЕпамКеуЕх ( рИКеу, @мКеу, зесЕ1оп_паще, &сЬМаше, МОШЬ, МО, 
МОТТ, МОБЬ) == ЕВВОВ_МО МОВЕ_ТТЕМ5) 
ргеаК; // выходим из цикла, если все подразделы получены 
// собираем путь для доступа к вложенному разделу 
з6гсру ( пем раеп, ""); 
ЗЕгсру ( пем раёр, НКЫМ ЕМОМ МТ); 
зегсае ( пем раёв, "\\"); 
з&гсае ( пем раёЪ, зес&1оп папе); 
// открываем вложенный раздел 
1Е ( ВедОрепКеуЕх ( НКЕХ ТОСАЦШ МАСНТМЕ, пем рае, 0, КЕУ ВЕАБ, 
&рбКеу2) == ЕВВОВ_$0ССЕЗ$) 


// сбрасываем счетчик 
ЯмКеу2 = 0; 
у1111е (1) 
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{ 


// определяем размер значения 
соМаше = 256; 
// перечисляем подразделы в открытом разделе 


1Е ( ВедЕпаюКеуЕх ( рЬКеу2, ЧмКеу2, пем ра®2, &сМаме, МОШ,, 
МОБ, МОБ, МОБ) == ЕВВОК_ МО МОВЕ ТТЕМ5) 
ргеаК; // выходим из цикла, если все подразделы получены 


// собираем путь для доступа к вложенному разделу 
зЕгсру ( пем раббЗ, ""); 

$&гсру ( пем раПЗ, пем раеП); 

зегсаф ( пем рабЗ, "\\"); 

зсгсас ( пех ра ВЗ, пем раеп2); 

// открываем вложенный раздел 
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Е ( ВедОрепКеуЕх ( НКЕУ ТОСАЬ МАСНТМЕ, пем рабйЗ, 0, КЕУ ВЕАР, 


&рЮКеу3) == ЕВВОВ_$50ССЕ$5$) 


// сбрасываем счетчик 

ЧмКеуЗ = 0; 

мр11е (1) 

{ 
// определяем размер значения 
СсОМаме = 256; 


1Е ( ВедЕпаюКеуЕх ( рЮКеуЗ, 9мКеуЗ, пем раф4, &сБМапе, 


МОГ, МОГ, МОГ, МОГЬ) == ЕВКОВ МО МОКЕ ТТЕМ$) 


БЬгеак; // выходим из цикла 
// собираем путь для доступа к вложенному разделу 
зЕгсру ( пем раеВ5, ""); 
зЕгсру ( пем раёб5, пем ра{3); 
зЕгсае ( пем раёб5, "\\"); 
зегсаЕ ( пем раеВ5, пем_ра®№4); 
// открываем вложенный раздел 
1Е (ВедОрепКеуЕх ( НКЕУ ТГОСАТ, МАСНТМЕ, пем_раей5, 0, 


КЕУ ВЕАР, &рИКеу4) == ЕВВОК $5О0ССЕ55$) 


Ям512е = 150; // размер данных 

// получаем описание устройства 

ВедаОцегуУа1аеЕх ( р|Кеу4, "Беу1серезс", МОБ, МО, 
{ .РВУТЕ) Вага Кеу, &9м512е); 

// сохраняем в основную структуру 

$Егсру ( Чеу1сезМТ [41таех] .Беу1серезс, Гага Кеу); 

$Егсру ( Ваг4а_кеу, ""); 

// получаем имя класса устройства 

@м512е = 50; 
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ВедбоегуУа1аеЕх ( рЮКеу4, "С1азз", МОБ, МОШ, 
( ГРВУТЕ) Вага _Кеу, &9м512е); 
зЕгсру ( Чеу1сезМТ [оТпаех] .С1аз5$, БагЯ_кеу); 
згсру ( Брага _Кеу, ""); 
// получаем дополнительное описание устройства 
Чм51те = 80; 
ВедчОчегуУа]1аеЕх ( риКеу4, "Ег1епа1уМаме", МО, МОШ, 
( ГРВУТЕ) Вага Кеу, &9м512е); 
$Егсру ( Чеу1сезМ№Т [аТп4ех] .Ег1епа1уМаше, Вага кКеу); 
зЕгсру ( Брага Кеу, ""); 
// собираем путь для доступа 
// основным параметрам устройства 
зегсаЕ ( пем рабр5, "\\Сопего1"); // И1паомз 2000/ХР/5ВЗ 
// зексаЕ ( пем рафр5, "\\ТодСопЕ"); // И1п9ом$ МТ 
// открываем раздел реестра 
1Е ( ВедОрепКеуЕх ( НКЕУ ТОСАЬ МАСНТМЕ, пем рафВ5, 0, 
КЕУ ВЕАР, &ррКеу5) == ЕВВОВ_$5О9ССЕ$$) 


Фи512е = з1тео0оЕ ( РАТА); // определяем размер данных 
// обнуляем структуру данных 
2ехоМепогу ( &сЕд, $з1теоЕ ( РАТА)); 
// получаем данные из реестра 
ВедОчегуУа1]леЕх ( рЬКеу5, "А11осСорЕЁза", МОМ, МОШ, 
( .РВУТЕ) &СЕа, &9м51те); 
// определяем количество описателей устройства 
Бог (111 =0; 1 < СЁЕЗ.Соопе; 1++) 
{ 
Еог ( 10 ) =0; } < сЕЗ.А11 1156[1].Раба115е.Сочпе; 
7++) 


// определяем тип данных 
З\1ЕСН ( сЁд.А11 115$%[1].ПабаТ1$е.19[7].Туре) 
{ 
сазе Роге_Туре: // порт ввода-вывода 
// получаем базовый порт 
Че\у1сезМТ [аТпдех} .Вазе Роге [аРог®_1п49ех] = 
СЕЧ.А11 11$%[1].Пафа115%.19[3].0.Роге.5хаге; 
// получаем завершающий порт 
Чеу1сезМТ [2Тпаех] .Еп9_Роге [ГаРог& 1п4ех].ГомРаге = 
СЁЧ.А11 1,15%[1]}.Рабар15%.19[3].а.РогЕ. 5% аге .ТомчРаг® 
+ сЁ9.А11 1156[1].РафаГ15е.19[)].а.Рог&.ЪепаеВ - 1; 
// получаем тип порта ввода-вывода 
1Е ( сЁ9.А11 11$6[1].Рафа1Т1з6.1а[)].Е1адз & 
РОВТ_МЕМОВУ) 
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Че\1сезМТ [ГаТпаех] .ТуреВазеРог® [аРог*_1п4ех] = 


РОВТ_МЕМОВУ; 
е1зе 1Е ( сЕ9.А11 115% [1].Рафат1$е.19[)].Е1адз & 
РОВТ_ТО) 
Че\1сезМТ [оТпдех] .ТуреВазеРог® [аРог*_1п4ех] = 
РОВТ_ТО; 


// увеличиваем счетчик 
иРогЕ 1п4ех++; 
ргеакК; 
сазе ТВО Туре: // номер прерывания 
Че\у1сезМТ [оТпдех] .1ВО Маюфег [оТВО 1п4ех] = 
СЁд.А11 115%[1].Бафар1зе.т1а[)].а.ТВО.Маюьег; 
ЭТВО 1паех++; 
Ргеак; 
сазе Метогу Туре: // адреса в памяти 
// получаем базовый адрес 
Чеу1сезМТ [оТп@ех] .Вазе_Метогу [эМетогу 1п4ех] = 
СЁЕа.А11 145% [1].Рафа113е.1а[)].1.Метогу. 5агк; 
// получаем завершающий адрес 
Чеу1сезМТ [аТпдех] .ЕпЯ_Метогу [аМепогу 1п4ех]}.ТоиРаге 
= сЕ9.А11 1155[1].Рабса115е.19[)].0.Мемогу. 56 аг®.ТомРаг® 
+ сЕ9.А11 115% [1]}.Раба115%.1а[)].ч.Метогу. Тепаей - 1; 
// определяем тип памяти 
1Е ( сЕ9.А11 115%[1].БафаТ15%.19[)].Е1ачз & 
МЕМОВУ ВЕАР ИВТТЕ) 
Чеу1сезМТ (оТпдех] .ТуреВазеМетогу [аРог®_1п49ех] = 
МЕМОВУ_ВЕАР_ ИВТТЕ; 
е15е 1ЕЁЕ ( сЁд.А11 115%[1].РафбаТ15е.19[)].Е1а9$ & 
МЕМОВУ ВЕАР ОМГУ) 
Че\у1сезМТ [оТпдех] .ТуреВазеМетогу [аРог& 1п9ех} 
МЕМОВУ ВЕАР ОМУ; 
Че\1сезМТ [аТп4ех] .ТуреВазеМетогу [аРогЕ_1п4ех} 
МЕМОВУ ВЕАР_ ОМГУ; 
Че\1сезМТ [аТп4ех] .ТуреВазеМетогу [аРог® 1п4ех} 
МЕМОВУ ИВТТЕ ОМГУ; 
оМепогу 1п9ех++; 
Огеак; 
сазе ОМА Туре: // номер канала ПМА 
// получаем номер канала 
Чеу1сезМТ [оТп4ех] . ОМА _Спаппе1 [оОМА 1п@ех] = 
СЁЧ.А11 115%[1].Рафа15е.1а[)}.а.0МА.Спаппе1; 
// определяем тип канала 
1Е ( сЕ9.А11 1156[1].ПГаба15&.19[)].Е1а9$ & 
ОМА_8) 
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Чеу1сезМТ [аТоаех] .ТурерМА [аРог& _1п4ех] = РМА 8; 

е15е 1Е ( сЕ9.А11 115%[1}.Раба15%.19[3]}.Е1ад5 & 
РМА_16) 

ЧеутсезМТ [аТпаех] .ТурерМА [иРогЕ_1п9ех] = ПМА 16; 

е1зе 1Е ( СсЁд.А11 11$6[1].Бафаь15е.14[3}.Е1а9$ & 
РМА_32) 

Чеу1сезМТ [аТпаех] .ТурербмМА [пРог{_1паех} = ГМА 32; 

оОМА 1паех++; 

ргеак; 


сазе ВизМипег Туре: // тип шины 

Чеу1сезМТ [аТпаех] .ВизМалфег [иВу$ 1п4ех]} = 
СЁч.А11 1156 [1].Рафат15%.1а[1].п.ВизМитюег . 5$аг*; 
ргеак; 


} 
// закрываем раздел и обнуляем счетчики 
1Е ( роКеу5) ВедС1озеКеу ( рЬКеу5); 
Роге 1паех = 0; 
оТВО 1таех = 0; 
оМешогу 1паех = 0; 
ОМА _1паех = 0; 
иВиз_1паех = 0; 
} 
// закрываем вложенный раздел 
1Е ( рЮКеу4) ВедС1озеКеу ( рШКеу4); 
// увеличиваем счетчик найденных устройств 
иТптаех++; 
} 
// увеличиваем счетчик для поиска следующего подраздела 
ЧмКеу3++; 
} 
// закрываем вложенный раздел 
1Е ( рЬКеуЗ) ВедС1озеКеу ( р№Кеу3); 
} 
// увеличиваем счетчик для поиска следующего подраздела 
@мКеу2++; 
} 
// закрываем вложенный раздел 
1Е ( рИКеу2) ВедС1озекКеу ( рИКеу2); 
} 
// увеличиваем счетчик для получения следующего подраздела 
ЯмКеу++; 
} 
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// закрываем корневой раздел и выходим из функции 
1Е ( рН—Кеу} ВедС1озеКеу ( рНКеу); 


Как видите, основные принципы получения информации об установленном 
оборудовании в профессиональной системе УМпао\з$ не сильно отличаются 
от пользовательского варианта. Изменилась только структура для хранения 
данных и названия разделов в реестре. Замечу только, что ключевой раздел, 
в котором хранятся описатели устройств, может иметь одно из двух воз- 
можных названий: 102Сош для \Ут4о\5 МТ 4.0 и более ранних версий или 
Сопего! для УЛпдо\$ 2000/ХР/$ВЗ. 


23.2. Самоликвидация исполняемого файла 


Необходимость в удалении исполняемым файлом (расширение ехе) самого 
себя возникает, в первую очередь, при разработке инсталляционных прило- 
жений. Можно конечно переложить всю работу на плечи потенциального 
пользователя, но вряд ли ваша программа от этого выиграет. Как бы там ни 
было, я расскажу о нескольких вариантах удаления ЕХЕ-файла, а выбор 
наиболее приемлемого способа останется за вами. 


Первый предлагаемый вариант будет работать только в операционных сис- 
темах У/т4о\5 9х/МЕ. Он позволит удалить не только сам файл программы, 
но и папку, если таковая имеется. Однако следует помнить, что удалить 
можно только пустую папку, поэтому перед вызовом функции удаления 
ЕХЕ-файла не забывайте очищать текущий каталог от вложенных папок и 
файлов. Пример функции, демонстрирующий первый способ самоуничто- 
жения исполняемого файла, представлен в листинге 23.3. 


Листинг 23.3. Первый вариант удаления исполняемого файла 





З1остаае <ифпдомз.1> 

// объявляем переменные 

// указатель на функцию РГгеелргагу 

фуре4еЕ ВОО ( ЕАВ РАЗСАГ* РЕМЕВЕЕЬТВВАКУ) ( НТМЗТАМСЕ); 
// указатель на функцию Бе1ебеЕ11е 

фуреаеЕ ВООТ, ( КАБ РАЗСАГ* РЕМРЕБЕТЕЕТЬЕ) ( ПРСТУТВ); 

// указатель на функцию Вепоуер1гескогу 

ТуредеЕ ВОО ( ЕАК РАЗСАГ»* РЕМВЕМОУЕОТВЕСТОВУ) ( ЬРСТЗТВ); 
// указатель на функцию Ех1ЕРгосез5 

фуредеЕЁ уо1а ( ЕАК РАЗСАТГ* РЕМЕХТТРВОСЕ$$) ( ОМОВЬ); 

// структура для хранения основных параметров 

фуреаеЕ зегисе 
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НТМУТАМСЕ №115; // дескриптор исполняемого файла 
ОМОВР ОмЕх1ЕСоде; // код завершения процесса 
сПаг з2РаейР11е [МАХ РАТН]; // путь к исполняемому файлу 
сваг 52РакВЕо1Аех [МАХ РАТН]; // путь к папке 
// указатели на системные функции 
РЕМЕКЕЕГТВВАВУ рЕпЕгеер1Ьгагу; 
РЕМРЕЦЕТЕЕТЬЕ рЕп0е1есеЕ11е; 
РЕМВЕМОУЕОТВЕСТОВУ рЁЕпКетоуер1гесвогу; 
РЕМЕХТТРВОСЕ$5 рЕпЕх1ЕРгосез$; 

} ЗБЪЕРЕБЕХЕ, *РЗЕБЕОЕБЕХЕ; 

// определяем дальний указатель 

суредеЁ уо1А ( КАВ РАЗСАТ* САШ. ЕХЕ} ( РЗЕБЕОЕЦЕХЕ); 

// функция удаления ЕХЕ-файла 

у014 5е1ЕЕхере1ефке_9Х ( ВОО БТзЕо1аег); 

// функция загрузки данных для удаления 

5фаЕ1с \014 ГоаЧРафа ( РЗЕБЕРОЕГБЕХЕ рЕхе}; 

// функция маркировки конечной точки в стеке 

5фае1с уо1а ЕпЯРафаб%аск (); 

// реализация функций 

5фаё1с уо1а БоаЧБафа ( РЗЕБРОЕБЕХЕ рЕхе) 

{ 
// выгружаем файл из текущего процесса 
рЕхе->рЕпгхее!1Ьгаку { рЕхе->115{); 
// удаляем его 
рЕхе->рЕпре1ефеЕ11е ( рЕхе->5;РабВЕ11е); 
// удаляем папку, если она пустая 
1Е ( рЕхе->рЕпВетоуер1тесвогу) 

рЕхе->рЕпКетоуе 1тгесеогу ( рЕхе->52Ра®ПГо14ег); 

// завершаем текущий процесс 
рЕхе->рЕпЕх:ЕРгосез5 ( рЕхе->4иЕх1(Соае); 

} 

5фаЕ1с уо1а ЕпаРавабЖаск () 

{ 
// просто отмечаем в стеке завершение данных 

} 

у01А 3е1ЕЕхере1ефе 9Х ( ВООБ ЮТ5Ео]а4ег) 

( 
ЗЕЬЕБЕЪЕХЕ ехе; // структура с данными 
ОИОВО Чмрака$12е = 0; // размер данных 
РМОВОЬ ОмЕх1ЕСоде = ОхрАБАРАРА; // код завершения 
НТМУТАМСЕ РКегпе1 = МОГЬ; // дескриптор модуля 
НАМОГЕ ЮМетогу = МОБ; // дескриптор памяти 
САБ. ЕХЕ рЕпЕхе = МОМ; // дальний указатель 


Глава 23. Трюки и секреты 817 


// обнуляем структуру перед использованием 
7егоМешогу ( &ехе, з12еоЁ ( ЗЕБЕРЕЬЕХЕ)); 
// определяем размер данных 
СмПБафа$12е = ( ( ТРВУТЕ) ( ОМОВО) Епараба5%аск - 
( ГРВУТЕ) ( ОМОВЬ) ГоааРафа); 
// получаем дескриптор загруженного системного модуля 
РКегпе1 = СеЕМоди]1еНапЯ1е ( "КЕВМЕГЗ2"); 
// в случае ошибки выходим из функции 
1Е ( ВКегрпе1 == МЫ) гебогп; 
// получаем дескриптор памяти для текущего процесса 
ЬМешогу = бекргосеззНеар (); 
// в случае ошибки выходим из функции 
1Е ( ЮМепогу == МОБЬ) гебогп; 
// выделяем свободную память для данных 
рЕпЕхе = НеарА11ос ( ЮМемогу, НЕАР 2ЕВО МЕМОВУ, Змрафа512е); 
// записываем в выделенную память наши данные 
пепсру ( рЁпЕхе, ГоаЯРака, ЧиРафа$12е); 
// заполняем пустые данные содержанием 
ехе.р1пзЕ = бееМоди1еНапЯ1е ( №); // дескриптор ЕХЕ-файла 
// указатель на функцию Егее!1Югагу 


ехе.рЕпЕгее!1Ьгагу = ( РЕМЕВЕЕБТВВАКУ) СееРгосАаагезз ( МКегпе1, 
"ггее[Г1Ьгагу"); 

// указатель на функцию ПБе1ефеЕ1]1е для АМТ 

ехе.рЁЕп0е1екеЕ11е = ( РЕМРЕГЕТЕРТЬЕ) СекРгосАаЧгезз ( ЮКегпе!1, 


"Бе1ебеЕ11еА"); 
// получаем имя и полный путь для ЕХЕ-файла 
СбесМоди1еЕ11еМаше ( ехе.П1п5%, ехе.52РафИЕ11е, МАХ_РАТН); 
// если необходимо удалить папку 
1Е ( БТзЕо1аег) 
{ 
// указатель на функцию Ветоуер1гес®огу для АМ5Т 
ехе .рЕпВепоуер1тгескогу = ( РЕМВЕМОУЕОТВЕСТОВУ) 
СесРгосАЯЯгезз ( ВКегпе], "Вепоуе01тескогуА") ; 
// удаляем имя файла из пути 
зЕгсру ( ехе.з2РаВЕо14ег, ехе.52Ра{ВР11е); 
*эегсПг ( ехе.з7РаВЕо14ег, '\\') =0; 
} 
е1зе // иначе записываем нулевое значение 
ехе .рЁЕпКетоуер1гесеогу = МО; 
// указатель на функцию Ех1Ргосе$з 
ехе.рЁЕпЕх1ЕРгосезз = ( РЕМЕХТТРКОСЕ$$) бекРгосАаАгезз ( ПКегпе1, 
"Ех1ЕРгосезз"); 
// записываем код завершения 
ехе.мЕхтеСо4е = ЧмЕхтЕСоде; 
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// передаем управление на область памяти, в которой находятся данные 
// нля самоликвидации ЕХЕ-файла 
рЕпЕхе ( &ехе); 
} 
// пример использования функции 5е1ЕБе1ефе 9Х 
106 САБЫВАСК М1пМа1п ( НТМЗТАМСЕ ЬТозфапсе, НТМ5ТАМСЕ ВРгемТизфапсе, 
ТРУТВ 1рСю9ГЛпе, 10 пСиа5Вом) 


// удаляем сами себя 
бе1ЕРе1ефе_9Х ( РАЬЗЕ); 
гебоуп 0; 


Принцип работы функции 5е1ЕЕхере1ехе 9х основан на добавлении в сво- 
бодную память выполняемого процесса специального кода. Данный код 
становится независимой частью процесса и позволяет выполнять любые 
действия по отношению к остальным загруженным модулям, в том числе и 
ЕХЕ-файлу. 


Второй рассматриваемый вариант удаления файла можно применять во всех 
версиях Упао\$, но для завершения операции потребуется перезагрузка 
системы. В папке с установленной системой У/Мпд0\$ присутствует про- 
грамма УЛишК.ехе. Она во время каждого запуска проверяет папку на нали- 
чие файла УЛпши.111. Если такой файл существует, программа обрабатывает 
его и по завершению переименовывает в УЛиши.Бак. Сам файл настройки 
позволяет переименовать или удалить указанные файловые объекты, разме- 
щенные в его разделе Вепаше. Пример функции показан в листинге 23.4. 





Листинг 23.4. Второй в 


#1ос1аае <илпаом$.Н> 

// функция удаления ЕХЕ-файла 

уо1а бе1ЕЕхере1ефе ( ВООГ ЮТзЕо1аег); 

// пишем реализацию функции удаления 

уо1а 5е1ЕБхере1еке ( ВООГ БТзГо1адег) 

{ 
// объявляем переменные 
СсВах $2РаЕ ВЕХЕ[МАХ РАТН]; // путь к файлу ЕХЕ 
СсВак з2Г1ретмт[1023]; // строка описания в файле М1пТп1е. 111 
свах $2М1паом$ [МАХ _РАТН}; // путь к папке \1шаомз ( М\омТ) 
сВаг з25есЕ1оп[] = "[Вепаме]\х\п"; // указатель раздела в М1п111&.111 
СВаг* рВепаме = МО; 
СВаг* РИТОТМТ = Ш; 
сваг* рЕг = №; 
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126 ШЛое $17е = 0, 15есё1оп 917е = 0; 

НАМОЬЕ ВЕ11е = МОШ., ЮМарЕ11е = Ш; 

БИОВР ЯмЕ11е512е = 0, @мРоз = 0; 

// получаем имя и ‘полный путь к файлу ЕХЕ 
СеЕМоа1еЕ11еМаме ( МОШ., з2РаЕВЕХЕ, МАХ РАТН); 
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// пытаемся пометить наш файл для удаления после перезагрузки системы 


1Е ( 'МоуеР11еЕх ( э2Ра ВЕХЕ, МО, МОУЕЕТЬЕ РЕЪАУ ОМТТЬ ВЕВООТ)) 


{ 
// если ошибка, выполняем операцию вручную 
// создаем строку для записи в файл М110111.1п1 


ТЫ] пе $12е = эриапЕЕЁ ( э211петмт, "МОт=%65\к\п", з7РаВЕХЕ); 


// вычисляем размер заголовка 

15есе1оп б12е = э1хеоЕЁ ( э25есЕ1оп) - 1; 

// получаем путь к папке И1па0м5$ 
Сеси1паом$О1кескогу ( 57М1пЧом5, МАХ_РАТН); 

// добавляем имя файла настройки 

зЕгсаЕ ( з2Млпаомз, "\\Итолат. 101"); 

// открываем или создаем новый файл М1п1п1%.1101 


ВЕ11е = СгеакеЕ11е ( 52М1пЧоиз, СЕМЕВТС ВЕАР | СЕМЕВТС МВТТЕ, 0, 


МОБ, ОРЕМ АГМАУ$, ЕТШЕ ЕЪАС ЗЕООЕМТТАЬ $САМ | 


ЕТЬЕ АТТВТВОТЕ МОВМАЬ, МОТЬ,); 
// если не удалось создать файл, выходим из функции 
ЗЕ ( БЕ1е == ТМУАГТР НАМОБЕ УАБОЕ) гебогп; 
// определяем размер файла 
ЧмЕ11е517е = СебЕ11е$1те( ВЕ11е, №0); 
// создаем неименованный объект отображения нашего файла 


ПМарЕ11е = СхеафеР11еМарр1пч ( №Е11е, МОБЬ, РАСЕ ВЕАРМВЛТЕ, 0, 
@мЕ11е512е + 114пе 512е + 15есё1оп 512е, №0); 


// если ошибок нет, работаем с новым объектом 
1Е ( ВМарЕ11е) 
{ 


// получаем объект отображения файла 


РИОПИТ = ( спаг*) МарУземОЕЕ11е ( ЮМарЕ11е, ЕТЬЕ МАР МВТТЕ, 0, 


0, 0); 
// если нет ошибок, ищем в файле нужный раздел 
1Е ( рИшмтТт) 
{ 
рВепаше = з6х5Ег ( рИПптмМТТ, $52бесё1оп); 
1Е ( рВепапе) // если раздел [Вепапе] найден 
{ 
// вычисляем конец данных для добавления своих 
рег = зЕксйхг ( рВепапе, '\п'); 
рех++; 
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мептоуе ( рёг + ИЛпе $12е, рег, 
РИ1ПТМТТ + 9мЕ11е512е - рег); 
// запоминаем позицию указателя в файле 
ЧмРоз = рег - РИшШтттТ; 
} 
е1зе // если раздел отсутствует 
{ 
// записываем в файл имя раздела [Вепаше] 
СЧМЕ11е512е += изрглпЕЕ ( &ритатмМТТ [9мЕР11е512е}, 
525есЕ1оп); 
// запоминаем позицию указателя в файле 
ЧмРоз = 9мЕ11е5127е; 
} 
// записываем в файл свои данные 
пепсру ( &ри1от\тТТ [9мРоз], з21петМТ, 1Ыше 512е); 
// освобождаем объект отображения файла 
ОптарУ1емОЕЕ11е ( рИшптмтт); 
// получаем новый размер файла 
@Е11е512е += 1Шпе 517е; 
} 
// закрываем файловый объект 
С1озеНарЯ1е ( РМарЕ11е); 


"55", 


// закрываем файл 

Зее Е11еРо1пеег ( ВЕ11е, 9мЕ11е512е, МОШ., ЕТЬЕ_ВЕСТМ); 
ЗеЕЕрЧОЕЕ11е ( ВЕ1]е); 

С1озеНапа1е ( ВЕ11е); 


Пример использования функции 5е1{Ехере1еее я не привожу, поскольку он 
ничем не отличается от предыдущего. При желании после несложных ис- 
правлений данную функцию можно применять для любых типов файлов. 


И последний способ удаления ЕХЕ-файла, который я хочу вам представить, 
заключается в создании старого доброго пакетного файла ВАТ. Работать 
этот способ будет во всех версиях \Мп4о\з, поддерживающих ВАТ-файлы. 
В листинге 23.5 показан пример реализации такого способа. 





Ч1остаае <М1пдомз.В> 
// функция удаления ЕХЕ-файла 
\01а 5е1ЁЕЕхере1ефе ( ВОО БТзРо1аег); 
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// пишем реализацию функции удаления 
\у01А 5е1ЕЕхере1ефе ( ВОО БТзЕо]4ег) 


{ 


// объявляем переменные 
НАМОГЕ ВЕ1]е = МОБ; // дескриптор файла 
РКОСЕЗ5 ТМЕОВМАТТОМ ргос_1пЁо; // информация о процессе 
ЗТАВТОРТМЕО 1пЁо; // информация о начальной загрузке программы 
РУЮВР амВукезИх16е = 0; // число записанных байтов 
сВаг з2ВаЕЕет [1000]; // буфер для данных 
СсВахг з2Ехе [МАХ РАТН]; // путь и имя ЕХЕ-файла 
сВаг з2РафВ [МАХ РАТН]}; // путь к ЕХЕ-файлу 
сВаг ВАТ[] = "\\Тирре1Ехе.ьае"; // имя временного пакетного файла 
// обнуляем структуры 
2егоМетогу ( &ргос 1пЕо, з12еоЕ ( РВОСЕЗ$_ТМЕОВМАТТОМ)); 
2егоМешогу ( &11Ео, $1хеоЕ ( ЭТАВТОРТМЕО)); 
// создаем новый файл для записи 
ВЕ11е = СгеафеЕ11е ( ВАТ, СЕМЕВТС ИВТТЕ, 0, МОТЬ, СВЕАТЕ_АБМАУЗ, 
ЕЕ АТТВТВОТЕ МОВМАГ | ЕТШЕ РЪАС ЗЕООЕМТТАЬ 5САМ, МОБ); 
// если ошибка, выходим из функции 
1Е ( БЕе != ТМУАБТО НАМОГЕ УАБОЕ) 
{ 
// получаем имя и путь к ЕХЕ-файлу 
Сесмоаа1еЕ11еМаще ( МОШ., з2Ехе, МАХ _РАТН); 
// выделяем только путь 
Егору ( з;РафП, з7Ехе); 


*зехсВг ( з2РабВ, '\\') = 0; 
// форматируем данные для ВАТ-файла 
зре1пЕ Е (з2ВоЕЕег, 


":Вереак\г\пЧе1 \"$з\"\хг\п1Е ех1зе \"%з\" добо" 
" Вереак\г\птматхг \"%5\"\г\пае1 \"$5\"\г\п", 
з2Ехе, з2Ехе, з2Ра®ер, ВАТ); 
// записываем данные в файл и закрываем его 
Мт1ееЕ11е ( ВЕ11е, з2ВоЕЁег, з&т1еп ( з7ВиЁЁЕег) * з1хеоЁ ( сраг), 
&ЧмВусезИг1ее, МОБ); 
С1озеНап1е ( ВЕ11е); 
// заполняем структуру на запуск 
10Е0.сю = 312е0оЕ ( 11Ёо); // размер структуры 
11Ео.ЧмЕ1ачз = ЗТАВТЕ ОЗЕЗНОМИТМООМ; // устанавливаем обработку окна 
1пЕо.м5ромИ1паои = 5И НТОЕ; // скрытое окно 
// создаем новый процесс 
1Е ( СгеафеРгосезз ( МОБЬ, ВАТ, МОШЬ, МОЫ., ЕАТЗЕ, СВЕАТЕ ЗОЗРЕМОЕР 
| ТОЬЕ РВТОВТТУ СТА$5, МОБ, "\\", &11о, &ргос_1тЕо)} 


// устанавливаем для созданного потока самый низкий приоритет 
ЗееТЬгеаЧРг1ог1Еу ( ргос 1пЕо.ВТИгеаЯ, ТНВЕАБ РВТОВТТУ_ТОЁЕ); 
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// устанавливаем наивысший приоритет для главного потока ЕХЕ-файла 
ЗеТЬгеаЧЯРт1ох1Еу ( СееСагхепЕТЬгеаа (), 
ТНВЕАО РВТОВТТУ ТТМЕ СВТТТСАТ); 
// устанавливаем высокий приоритет для текущего потока 
ЗеЕРт1ог16уС1аз5 ( беЕСоггепеРгосезз (), НТСН РВТОВТТУ С1А$$); 
// закрываем дескриптор процесса 
С1озеНапа1е ( ргос 1пЕо.ВРгосе$з); 
// приостанавливаем выполнение потока 
ВезимеТргеаЯ ( ргос 1пЕо.ВТЬгеаа); 
// закрываем дескриптор потока 
С1озеНапа1е ( ргос_1пЕо.ПТЬтеаа); 


Итак, сначала мы создали новый пакетный файл и записали в него стан- 
дартные команды ООЗ для удаления файла и родительской папки. После 
этого на основе ВАТ-файла открыли новый процесс с помощью функции 
СгеакеРхосезз И запустили его на выполнение. И наконец, изменив приори- 
теты текущего и вновь созданного процесса, закрыли дескрипторы создан- 
ного процесса и его основного потока. Система запустила на выполнение 
пакетный файл ТтрОе!Ехе.Ъа, удалив тем самым наш ЕХЕ-файл. Чтобы 
лучше понять работу функций 0О$, ознакомьтесь с соответствующим руко- 
ВОДСТВОМ. 


23.3. Создание прозрачных окон 


Эта интересная возможность, довольно легко реализуемая в \У- 
Ч4о\з 2000/ХР/ЗВЗ, к сожалению, не поддерживается в пользовательских 
системах \/шдо\$ 9х/МЕ. Чтобы восполнить этот пробел, напишем собст- 
венный код, позволяющий превратить любое окно (в том числе и элементы 
управления) в прозрачную поверхность. Для этого нам понадобится напи- 
сать всего три несложных функции. Создайте новый проект и добавьте 
стандартный код регистрации класса окна. Добавьте оконную функцию об- 
работки сообщений У!пдо\5 и определите следующие сообщения: 
ММ СВЕАТЕ, ИМ РАТМТ, ИМ $Т2Е И ИМ ИТМООИРОЗСНАМСЕР. Обработайте эти сооб- 
шения так, как показано в листинге 23.6. 


}1остаде "зЕдаЕх.В" 

// объявляем глобальные переменные 

НВТТМАР ПОезкфор = МОБЬ, НВТТМАР ВОезКк®ор2 = МШ., Ю5сгееп = №; 
ВЕСТ гесф, гесф2, гес\З; 
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// уровень прозрачности 
106 1Ъеуе1 = 100; 
// копирование текущего содержимого экрана 
НВТТМАР бауебстееп ( ПРВЕСТ 1рВесе); 
// перерисовка прозрачного окна 
уо1А УрааферРа1пеТгапз ( НИМО ЮИпа); 
// создание эффекта прозрачности 
у01А Тгапзрагепсу ( НОС асТи, НОС асОвЕ, 1пе 1еЕЕ 4п, 1пЕ бор 1, 
Та г1аре 1п, 106 Бобом 1п, 1 1еЕб_ од, 11Е бор оче, 
10 Е19Пе одЕ, аб Боббом сое); 
// оконная функция для обработки сообщений И1п490\5$ 
ТВЕЗОЬТ САШВАСК ИраРгос ( НИМО Випа, ОТМТ пизда, ИРАВАМ мРагам, 
ТРАВАМ 1Рагап); 
// реализация функций 
НВТТМАР Зауебсгееп ( ГРВЕСТ 1рВесф) 
{ 
НВТТМАР ЮВир = МОТ, ВТирВир = М№ОШ.; // дескринторы изображений 
НОС 1прС = МОБЬ, шешбс = МО; // дескрипторы для контекстов 
306 1М1АЕЬ = 0, 1Не19ЪЕ = 0; // размеры изображения 
1106 х тез = 0, у гез = 0; // текущее разрешение экрана 
ВЕСТ к; // хранение размеров прямоугольника 
// проверяем корректность размеров прямоугольника 
1Е ( ТзВесЕеЕшреу ( 1рВес®))} 
тевиго МОГ; // в случае недопустимых координат, выходим 
// создаем контекст для стандартного устройства отображения 
10рС = Сгеаверс ( "РТ5РПАУ", №, МОШ, №); 
// создаем в памяти контекст, совместимый с созданным ранее 
петрС = СхеакеСотра*151ер0С ( 1110С); 
// определяем текущее разрешение экрана в пикселах 
х гез = беЕреу1сеСарз ( 110С, НОВ2ВЕЗ); // по горизонтали 
у тез = беереу1сеСарз ( 1п0С, УЕВТВЕЗ); // по вертикали 
// получаем размеры прямоугольника 
г.1еЕЕ = 1рВесе->1еЕс; 
г.Еор = 1рВесе->®ор; 
т.х1овЕ = 1рВесе->г198е; 
г.роЕбом = 1рВесе->Ьоеоп; 
// вычисляем размеры прямоугольника 
ТИТаЕВ = г.г19ре - г.1еЕ%; 
1НезавЕ = г.роебом - г.Фор; 
// создаем изображение с заданными размерами 
ЮВир = СгеабеСотрае1р1еВ1Етар ( 11[С, 1МЗаЕВ, 1Не19®); 
// копируем изображение в контекст памяти 
ВТирВир = ( НВТТМАР) 5е1есЕОр]есе ( мепрс, ПВмр); 
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// копируем изображение из памяти на экран 
ВАЕВ1Е ( пепрбс, 0, 0, аи1аЕв, 1Нелаве, 1п0С, г.1еЁё, к.бор, ЗВССОРУ); 
// восстанавливаем прежнее изображение для контекста 
№Вир = ( НВТТМАР) $е1есеОБ)есе ( метрС, ВТирВпр); 
// освобождаем ресурсы системы 
Бе1еберС ( мерс); 
Бе1еЕерС ( 110С); 
// возвращаем дескриптор изображения 
тебогп НВпр; 
} 
уо1а ОрааееРа1пеТкапз ( НМИМО имМпа) 
{ 
РАТМТУТВОСТ рёз; // структура для рисования 
НОС №515р1ау = МОШ., петбСс = МОЫ., Барбос = МОМ, вароСс = МО; 
ВЕСТ г, г2, 3; 
НВТТМАР шещВир = МОТ, о1ЧВир = МОЪЬ, ЕтрВир = МОМ, етрВир2 = МОШ, 
ЫтрВир3 = МОБ, трВир4 = МОБЬ; 
// получаем контекст для рисования 
НОС ВОС = Вед1пРа1те ( ВМпа, &реЗ); 
// получаем текущие размеры окна 
СеЕ\Я1паомВесе ( ВМпа, &г); 
// сохраняем размеры прямоугольника для дальнейшего использования 
у2.Боебом = к.БоЕбом - г.бор; 
:2.г1арЕ = г.х19ЪЕ - к.1еЕ; 
// создаем контекст для стандартного устройства отображения 
Ь515р1ау = СкеаеебС ( "РТ5РШЬАУ", МОБ, МО, МЫ); 
// создаем в памяти контекст, совместимый с созданным ранее 
петОС = СгеабеСотрае151е0С ( пО1зр1ау); 
// создаем временный контекст для обработки изображения 
ЧпрОС = СгеабеСотраЕ1ю1е С ( №0С); 
// определяем координаты пересекающихся прямоугольников 
1Е ( ПиегзесёВесЕ ( &к3, &к, &гесёЁЗ)) 
{ 
// создаем в памяти совместимый контекст 
пешОС = СгеаЕеСопраЕ151ерС ( в01зр1ау)}; 
// копируем изображение в контекст 


метВтр = ( НВТТМАР) $е1есЕОБ)есЕ ( меюбС, ВОезКеор); 
// копируем изображение в контекст 
о14Вир = ( НВТТМАР) $е1есеОр]есЕ ( барЬС, ЮБезК®ор2); 


// копируем изображение из одного контекста в другой 

ВаЕВ1Е ( метрС, +3.1еЕ6, х3.6ор, кЗ.кааре, хЗ.Боебот, трос, 
:3.1еЕё, г3З.кор, $ЗВССОРУ); 

// восстанавливаем прежнее изображение 

5е1есЕОБ]есЕ ( %+трбС, о19Впр); 
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// копируем изображение в контекст памяти 

ЬБезкеор = ( НВТТМАР) 5е1есеОБ)есе ( пепОС, мепВпр); 
} 
// копируем размеры прямоугольника 
гесё3 = кг; 
// копируем изображение в контекст памяти 
ЕтрВир = ( НВТТМАР} бе1есеОБзесе ( метрС, поезкеор}; 
// создаем битовое изображение 
ЕпрВлр2 = СгеакеВ1тар ( г2.х1аБе, к2.роббом, 1, 

Сеереу1сеСарз ( ВОС, ВТТЗРТХЕТ), №); 

// копируем изображение в контекст 
ЕтрВирЗ = ( НВТТМАР) Зе1есеОБ)есе ( трос, втрВир2); 
// копируем изображение из одного контекста в другой 
В12В1Е ( чирбС, 0, 0, к2.узаВЕ, к2.Боббом, пешОС, к.1еЕё, г.бор, 


ЗВССОРУ); 
// выбираем изображение в контекст памяти 
ЬБезКеор2 = ( НВТТМАР) $е1есеОБ)есе ( пепОС, трВир); 


// освобождаем контекст 

БРе1еёерс ( мепосС}; 

// создаем совместимый контекст 

ЫпроС = СгеабеСопра&1ю1е0 С ( ВОС); 

// выбираем изображение в контекст 

ЕпрВлр4 = ( НВТТМАР) 5е1есеОБ)есе ( ыпррС, Ъ5сгееп); 

// создаем эффект прозрачности для указанного изображения 

Ткгапзрагепсу ( &пррс, ытрОС, 0, 0, :2.у1а0е, к2.Бобфом, 0, 0, 

и2.х190е, х2.Боббом); 

// копируем изображение из одного контекста в другой 

В1еВ1Е ( Ю015зр1ау, к.1еЕб, х.бор, х2.х19Ве, г2.Бобфкош, ЕтрбС, 0, 0, 
ЭВССОРУ)} ; 

// восстанавливаем прежнее изображение 

Зе1есеОр)есе ( рос, &прВпр2); 

// освобождаем контекст 

Бе1екерС ( &пррс); 

// восстанавливаем прежнее изображение 

Зе1ессОБ)]есе ( БОСС, &трВмрА); 

// освобождаем контекст 

Бе1ефебс ( БпроС); 

// заверщаем рисование 

ЕпаРа1пе ( ВМпа, &р®з); 

Бе1еберС (1015р1ау}; // освобождаем контекст 

// сохраняем текущее изображение экрана 

ЬБезКкЕор = Зауебскееп ( &гес®); 
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у01А Тгапзрагепсу ( НОС астТп, НОС асоде, 10е 1еёё 11, 11Е вор 11, 


{ 


1пЕ ттаНе 1п, ле Боевом 1, тп 1еЁе обе, 108 фор ое, 1пЕ к19ЪЕ обе, 
106 роббом обе) 


// структура для хранения параметром битового изображения 
ВТТМАРТМЕОНЕАОЕВ пр; 

ВУТЕ* ртив1+е5 = МОБ; 

ВУТЕ* рочеВЯез = МОБ; 

НВТТМАР РтпВир = МОБЬ, ВОаеВир = МОБ, ВТирВир = МОБ; 
НОС ас = Ы;; 

// обнуляем структуру 

2егоМетогу ( &юшр, з17теоЕЁ ( ВТТМАРТМЕОНЕАРЕВ)); 

// заполняем структуру данными 

Бтр.р151хе = $1хеоЁ ( ВТТМАРТМЕОНЕАРЕВ); // размер структуры 
пр. Ю1\1аЕН = г190Е 11; // ширина изображения 
Бир.Ю1НезарЕ = робком 10; // высота изображения 


Ьтр.Р1Р1апез = 1; // число плоскостей всегда равно 1 
ыир.Б1В1ЕСоцрЕ = 32; // число битов для описания одного пиксела 
Бар.51Сотргез51оп = ВТ ВСВ; // без сжатия данных 
// создаем целевое растровое изображение 
БТоВир = СгеафертТВ$есЕ1от ( ЧсОйе, ( ВТТМАРТМЕО*) &бтр, 
ОТВ ВСВ СОГОВ$, (%019**) &ртоВ1Е$, МОМ, 0); 
// создаем исходное растровое изображение 
РОцЕВтр = Сгеа®еПТВ$есе1оп ( асТп, ( ВТТМАРТМЕО*) &Бтр, 
ОТВ ВСВ _СОГШОВ$, ( уо1а**) &роцЕВ1з, МОШ, 0); 
// создаем контекст, совместимый с текущим экраном 
с = СгеабеСотра&11е0 С ( №11); 
// копируем изображение в контекст 
БТарВир = ( НВТТМАР) 5е|1есеОБ]есе ( ас, БТоВпр); 
// копируем целевое изображение и подгоняем размеры 
Зегессьв1е ( ас, 0, 0, хааьЕ 1п, Боевом 11, АсОаЕ, ЛеЁЕ обе, короче, 
х195еЕ оче, Боееом обе, 5ВССОРУ); 
// выбираем изображение в контекст 
ЗелесеОБ]есе ( ас, ВОс&Вир); 
// копируем исходное изображение и подгоняем размеры 
ЗЕхеесвв1е ( ас, 0, 0, хааьЕ 1п, Боееом 1п, Асти, 1еЁё 1, фор 1т, 
х1а9НЕ_1п, роббом 1п, ЗВССОРУ); 
// выбираем изображение в контекст 
ЗелесЕОБ]есЕ ( ас, БТирВпр); 
релеЕеос ( ас); 
// обрабатываем каждый байт изображения для получения прозрачности 
Еог ( ШЕЕ = 0; 1 < Боефом 11; ++1) // по вертикали 
{ 
ТРВУТЕ ртивСВ = ( РВУТЕ) &( ( 0МОВО*) ртаВ1+$) [1 * клаве 11]; 
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ТРВУТЕ рОсЕВСВ = ( ГРВУТЕ) & ( ( ОМОВО*) робЕВ1з) [1 * тлаВе 11]; 
Еог ( 106 ) = 0; ) < каче 11; ++)) // по горизонтали 
{ 


// вычисляем новое значение каждой составляющей цвета 


РТовСв[0] = ( рочЕВСВ[0] * ( 255 - 11еуе1) + ртавсв[0] * 
1Теуе1) >> 8; 
РГоВСВ[1] = ( рОчВСВ{1] * ( 255 - 11еуе!1) + ртоВСВ[1] * 
1Теуе1) >> 8; 
РТаВСВ[2] = ( рРО`ЕВСВ[2] * ( 255 - 11еуе1) + ртовСсв[2] * 
1Теуе1) >> 8; 
ртовсв += 4; 


РОЧЕВСВ += 4; 
} 
} 
// создаем контекст, совместимый с текущим экраном 
Ас = СгеафкеСотра®11ерс ( М0Ш)); 
// выбираем обработанное изображение 
РТирВир = ( НВТТМАР) Зе1ес®Ор]есе ( ас, ВТоВпр); 
// копируем изображение из одного контекста в другой 
В1В16 ( Асти, 1еЕё 10, вор 1т, главе 1, роббом 10, ас, 0, 0, 
ЗВССОРУ) ; 
// освобождаем системные ресурсы 
Ре1ефеоБ3есе ( ВТиВпр); 
Бе1ефе0ю)есЕ ( РОц%Втр); 
Ре1еферС ( ас); 
} 
// основная оконная функция программы 
ТВЕЗОШТ САБЪВАСК ИпаРкос ( НИМО Рипа, отмТ пза, МРАВАМ иРагам, 
ТРАКАМ 1Рагам) 


ВЕСТ г; // хранение координат прямоугольника 
// выполняем обработку сообщений 
5и1Еср ( 159) 
{ 
сазе ММ СВЕАТЕ: 
{ 
// получаем размеры клиентской области окна 
СефС11епЕВес® ( СеЕпезК®орИ1паом (), &гес®); 
// копируем в виде растрового изображения в память 
ПОезкеор = бауебсгееп ( &гес®); 
} 


ргеак; 
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сазе ИМ РАТМТ: 
( 
// перерисовываем окно 
Ор4акерРа1пеТгапз ( ВИпа); 
} 
Бгеак; 
сазе ИМ $Т2Е: 
{ 
// получаем размеры окна 
Сееи1паомВесе ( ПМпа, &г}; 
// обновляем содержимое окна 
Тлуа1}Чабевесе ( П\па, &г, &гие)}; 
// копируем в виде растрового изображения в память 
Ьбсгееп = бауебсгееп ( &г); 
} 
Бгеак; 
са5е ИМ ИТМООИРО$СНАМСЕЬ: 
{ 
ТРИТМРОИРО$ роз; 
// выделяем указатель на структуру ЪРИТМООЙРО$ 


роз = ( .РИТМООИРО$) 1Рагаш; 
// проверяем текущие размеры окна 
1Е ( ( роз->сх != гес®2.к19Бе) || ( роз->су != гесё2.ро{ом)) 


{ 
// получаем размеры окна 
Сееи1паомВесе ({ БМпЯ, г); 
// обновляем содержимое окна 
Труа11Засевесе ( Б\па, &г, Ехае); 
// копируем в виде растрового изображения в память 
бсгееп = бауебсгееп ( &г); 
} 
Е ( ( роз->х != гесё2.1еЕ®) || ( роз->у != гес®2.еор)) 
Роз&Меззаде ( ВИпЯ, ММ РАТМТ, 0, 0}; // перерисовка окна 
// сохраняем размеры окна 
гесё2.1еЕе = роз->х; 
тес®2.к14Ъ5е = роз->сх; 
гесЕё2.кор = роз->у; 
гес&2.Боебом = ро5->су; 
} 
ргеак; 
// завершение работы программы 
сазе ИМ БЕЗТВОУ: 
РозОц1ЕМеззаде (0); 
Бгеак; 
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деЁаз1е: 
хебигп БеЕМ1паомРгос ( ВИп4, изд, мРакам, 1Ракам); 


} 


гегогп 0; 


Представленный код позволяет отображать главное окно программы полу- 
прозрачным. Уровень эффекта можно изменять с помощью значения пере- 
менной 11еуе1. Для создания прозрачных окон в УМш9о\5 2000/ХР/$ВЗ дос- 
таточно воспользоваться библиотечной функцией зестьауехедипдомАкек1Ькез. 
Кроме того, не требуется дополнительной обработки системных сообщений, 
поскольку все это система выполняет самостоятельно. Изменять уровень 
прозрачности можно в любой момент выполнения программы. Те, кто ис- 
пользует \У15иа| Зою .МЕТ, могут вызывать функцию непосредственно, а в 
УС+- 6.0 имеет смысл вручную определить требуемые константы и приме- 
нить динамический способ обращения к системной библиотеке. Связано 
это в первую очередь с устаревшими версиями файлов определений, входя- 
щих в состав оболочки. Пример реализации прозрачного окна представлен 
в листинге 23.7. 





истинг 23.7. Создание прозрачного окна в \Ит4о\з 2000 





#1пс1а4е "з&4аЕх.в" 
// объявляем глобальные переменные 
#АеЁ1пе 1МА АБРНА 0х00000002 // используем эффект прозрачности 
#ЧеЕ1пе М5 ЕХ ТАУЕВЕЬ 0х00080000 // расширенный стиль окна 
// уровень прозрачности 
ВУТЕ БуГеуе]1 = 100; // от 0 ( прозрачно} до 255 ( не прозрачно} 
НМОРОЪЕ ВОзек = МО; // дескриптор библиотеки 0зег32.411 
// указатель на функцию Зе ГауегедИ1таАомАЕ г1роеез 
фуредеЕ ВОО ( МТМАРТ* РЕМЗЕТТАУЕВЕРИТМАТТВ) ( НИМО Бута, 
СОТГОВВЕЕ стКеу, ВУТЕ БА1рБа, ОМОВР @мЕ1аа5); 
// функция для добавления эффекта прозрачности 
Уо1А Тгапзрагепсу ( НИМО ВИпа, ВУТЕ Бу!еуе1); 
// реализация функции 
уо1А Ткапзрагепсу ( НИМО ВИр4, ВУТЕ Бу!еуе1) 
{ 
// указатель на функцию Зе ГауегедИ1паомАе* "зробез 
РЕМЗЕТЬАУЕВЕОИТМАТТВ рЁЕпбесГауегедИ1 пдомАсек1рокез; 
// загружаем библиотеку 0зег32.911 
ВОзег = СеЕМодо]еНап41е ( "95ЕВЗ2"); 
1Е ( №Эзег == МОШ,) кебогп; //выходим в случае ошибки 
// добавляем к окну стиль для поддержки прозрачности 
Зееи1паонТЪопа ( БИпа, СИЪ ЕХЗТУТЕ, И5_ЕХ ТАУЕВЕО) ; 
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// получаем указатель на функцию беёТауегедИ1па9омА Е г1рифез 
рЕпбеТтауегедИ1паомАеег1рифез = 
( РЕМЗЕТЬАУЕВЕРИТМАТТВ) СеЕРгосАаагезз ( ВОзег, 
"бесГауеге Я И1паомАе&г1Биеез"); 
// если достун к функции получен 
1Е ( рЕпбеТауегедИ 1паомАветаБаеез != МО) 
{ 
// устанавливаем уровень прозрачности для плавного окна 
рЕпбееТауеге И1паомАег1раеез ( ВМпа, МОШ., БуЁеуе1, ТМА АПРНА); 


Думаю, пример достаточно простой и не требует специальных пояснений. 
Добавьте функцию Тгапзракгепсу в обработку сообщения им СВЕАТЕ и не за- 
будьте по завершению программы освободить библиотеку с помошью 
Егее!11ргагу. 


23.4. Определение устройств ЦВ 


В последнее время увеличился интерес разработчиков к программированию 
устройств с интерфейсом ЦЗВ. Это объясняется тем, что появилось огром- 
ное количество всевозможного оборудования: звуковые карты, винчестеры, 
приводы СО-КОМ и СО-КМ, сканеры и принтеры. К сожалению, свободно 
распространяемая документация очень скудно описывает методы работы с 
данными устройствами. Я постараюсь отчасти восполнить этот пробел и 
расскажу о базовых приемах, позволяющих получить различную полезную 
информацию о подключенных устройствах ЦЗВ. 


В первую очередь, нам понадобятся файлы определений (в частности 
1454.0), входящие в состав пакета для разработки драйверов (РОК — 
Пихег Реуеорег$ КИ$). Данный пакет можно свободно скачать с официаль- 
ного сайта фирмы М!сгозой (ум\.писгозой.ги). Кроме того, необходимо бу- 
дет добавить в опциях компоновщика ссылку на библиотеки Н!а.П6 и 
Зешрар!.16. Чтобы упростить код, вынесем в отдельный файл необходимые 
для поддержки ОЗВ константы и структуры, и назовем его избаеБ.Н. Полное 
описание этого файла представлено в листинге 23.8. 





Листинг 23.8. Файл поддержки ИЗВ-устройств изЬБдеёз.В 





// нодключаем файл определений из пакета РОК 
ехфегп "С" 


{ 
Н1ос1аае "В195а21.6” 
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// базовые коды ввода-вывода 


#1ос1аае <и1лл 
// максимальна 


осет.[> 
я длина строки описания 


#Че1пе МАХТМОМ 05В $ТВТМС ТЕМСТН 255 


// типы дескри 


пторов 


#+АеЕ1пе 05В_СОМЕТСОВАТТОМ РЕЗСВТРТОВ_ТУРЕ 0х02 


#АеЕ1те 05В_ 5ТВТМс РЕЗСВТРТОВ_ТУРЕ 0х03 
#ЧеЕ1пе О5В ТМТЕВРАСЕ РЕЗСВТРТОВ_ТУРЕ 0х04 
// типы классов для устройств 05В 

#ЧеЕ1пе ОЗВ РЕУТСЕ С1А$$ ВЕЗЕВУЕР 0х00 
#+АеЕ1пе О5В_ РЕУТСЕ_СТЪА$$ АИОТО 0>01 
#+АеЕ1те 05В_ОЕУТСЕ_СТА$5 СОММОМТСАТТОМ$ 0х02 
+аеЕ1пе ОЗВ РЕУТСЕ_СЪА$З$ НОМАМ ТМТЕВЕАСЕ 0х03 
+ЧеЕ1пе О5В РЕУТСЕ_СЪА$$ МОМТТОВ 0>04 
#ЧеЕ1пе 0$В ОЕУТСЕ СТАЗ$ РНУЗТСАГ, ТМТЕВЕАСЕ 0х05 
#ЧеЕ1пе 0$5В_РЕУТСЕ_СТАЗ 5 РОИЕВ 0х06 
#АеЁ1пе 95В РЕУТСЕ_СЪА$$_РЕТМТЕВ 0х07 
#АеЕ1пе 05В РЕУТСЕ_СЪАЗ$ $ТОВАСЕ 0х08 
#ЧеЕ1пе 95В РЕУТСЕ СТАЗЗ НОВ 0х09 





#ЧеЕ1пе О5В РЕУТСЕ_СЪАЗ$ УЕМООВ ЗРЕСТЕТС — ОхЕЕ 


// коды ввода- 
#АеЕ1пе ЕТЬЕ_ р 
#АеЕ1пе О5В_ТО 
#АеЕ1тте ТОСТ | 





#АеЕлпе ТОСТГ | 


вывода для функции Пеу1сеТоСопего1 

ЕУТСЕ 05В ЕГЬЕ РЕУТСЕ ОМКМОИМ 

СТ ТМОЕХ ОхООЕЕ 

О5В СЕТ МОРЕ ТМЕОВМАТТОМ СТБ СОБЕ ( ЕТЬЕ ОЕУТСЕ 95В, \ 
О$В_ТОСТЬ_ТМОЕХ + 3, МЕТНОР ВОЕЕЕВЕО, ЕТГЕ АМУ АССЕ55$) 
О5В СЕТ ВООТ НОВ МАМЕ СТЬ СОБЕ ( ЕТЬЕ РЕУТСЕ 05В, \ 

О5В ТОСТЬ ТМОЕХ + 3, МЕТНОР ВОЕЕЕВЕОР, ЕТЫЕ АМУ АССЕЗ5) 


#Че1пе ТОСТЬ О5В СЕТ МОРЕ СОММЕСТТОМ ТМЕОВМАТ ТОМ 





СТЬ СОБЕ ( 


ЕТЬЕ РЕМТСЕ ОВ, ЗВ ТОСТТ ТМОЕХ + 4, МЕТНОР ВОЕЕЕВЕР, \ 
ЕТТЕ АМУ АССЕЗ5) 





#АеЁ1пе ТОСТГ, О5В СЕТ РЕЗСВТРТОВ ЕВОМ МОРЕ СОММЕСТТОМ 


СТЬ СОБЕ ( 


#АеЕзпе ТОСТЬ | 


ЕТЬЕ РЕУТСЕ О5В, О5В ТОСТЬ ТМОЕХ + 5, МЕТНОР ВОЕЕЕВЕО, \ 
ЕТЬЕ АМУ АССЕ$5) 

ОВ СЕТ МОРЕ СОММЕСТТОМ МАМЕ СТЬ СОРЕ ( ЕЕ ОЕУТСЕ 0$В, \ 

О5В ТОСТ ТМОЕХ + 6, МЕТНОР ВОЕЕЕВЕО, ЕТЬЕ АМУ АССЕЗ$) 





+АеЕ1пе ТОСТЬ 05В СЕТ МОБЕ СОММЕСТТОМ ОВТУЕВКЕУ МАМЕ 





СТТ СОБЕ ( 


ЕТЬЕ РЕ\ТСЕ ОВ, ЗВ ТОСТЬ ТМОЕХ + 9, МЕТНОР ВОЕЕЕВЕР, \ 
ЕТЬЕ АМУ АССЕЗ5) 


#АеЕ1пе ТОСТГ СЕТ НСО ОВТУЕВКЕУ МАМЕ СТЬ СОБЕ ( ЕТЬЕ ОРЕУТСЕ ОЗВ, \ 


// структуры д 
#$ргадша раск ( 


0$В ТОСТЬ ТМОЕХ + 10, МЕТНОР ВОЕЕЕВЕОР, ЕТШЕ АМУ АССЕЗ5) 
анных 
1) 


832 Часть И. Общие методы программирования в И/пдоми$ 


// описатель дескриптора устройства 
суреаеЕ зекасе _О$В_ТМТЕВЕАСЕ_ОЕЗСВТРТОВ { 

ОСНАВ БЪепа®; 

ОСНАВ ЮБезсе1р®отТуре; 

ОСНАВ БТпёегЕасемитьег; 

ОСНАВ БА1Сегпасебее1па; 

ОСНАВ БМимЕпаро1 1$; 

ОСНАВ БТпбегЕасеС1аз3; 

ОСНАВ ЬТпбегЕасебаЬС1азз; 

ОСНАВ БТлеегЁасерРго®осо1; 

ОСНАВ 1Треет#асе; 
} 95В ТМТЕВЕАСЕ РЕЗСВТРТОК, *РОЗВ_ТМТЕВЕАСЕ РЕЗСВТРТОВ; 
// дополнительный описатель дескриптора устройства 
суреаеЕ зегосЕ _О$В_ТМТЕВЕАСЕ РЕЗСВТРТОВ2 { 

ОСНАВ  БЬепа®В; 

ОСНАВ ББезсу1реогТуре; 

ОСНАВ БТпеегЕасеМилюек; 

ОСНАВ БА1егпакебееЕ1та; 

ОСНАВ  БМжЕпаро1т($; 

ОСНАК БТпеегЁасеС1а$$; 

ОСНАВ РТрбегЕасебоЬС1аз5; 

ОСНАВ БТпеегЁасеРгокосо1; 

ОСНАВ 1ТпбетЁасе; 

ОЗНОВТ мМитС1аз5е$; 
} О5В ТМТЕВЕАСЕ РЕЗСВТ РТОВ2, *РИЗВ ТМТЕВЕАСЕ ОЕЗСВТРТОВ2; 
// описание конфигурации 
суредеЕ зегисЕ _О5В СОМЕТСОВАТТОМ РЕЗСВТРТОВ { 

ОСНАВ БЪепаеВ; 

ОСНАВ ЮБезст1реотТуре; 

ОЗНОВТ мТоба]Телаеь; 

ОСНАВ БМ№опТпеегЕасез; 

ОСНАВ ЮСопЕ1дакае1опУате; 

ОСНАВ 1СопЁ1дага&1оп; 

ОСНАВ БоАЕЕЕ1роее5; 

ОСНАВ МахРомег; 
} О5В СОМЕТСОВАТТОМ РЕЗСВТРТОВ, *РОЗВ СОМЕТСОВАТТОМ РЕЗСВТРТОКВ; 
// описатель основного дескриптора устройства 
суредеЕ зегасЕ _О5В СОММОМ РЕЗСВТРТОВ { 

ОСНАВ БЪераЕВ; 

ОСНАВ БРезсуи1реогТуре; 
} ОЗВ_СОММОМ РЕЗСВТРТОВ, *РОЗВ СОММОМ БЕЗСВТРТОВ; 
// описатель корневого устройства 
фуреаеЕ зекосеё _О$В КООТ_НОВ_ МАМЕ { 

ОТОМС Асбоа]1Ъепа®ь; 
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МСНАВ Воо&НоБМапе [1]; 
} ОЗВ ВООТ НОВ МАМЕ, *РОЗВ_БООТ НОВ МАМЕ; 
// параметры подключенного к хабу устройства 
$суредеЕ зегасЕ _Ч3В_МОБЕ СОММЕСТТОМ МАМЕ { 
ОТОМС СоппесЕ1опТпаех; 
ОЪОМб Ассаа1Ъептаень; 
ЯСНАК МодеМате [1]; 
} ОЗВ МОРЕ СОММЕСТТОМ МАМЕ, *РИЗВ МОРЕ СОММЕСТТОМ МАМЕ; 
// описание драйвера устройства 
суреаеЕ зегасЕ _О5В_МОБЕ СОММЕСТТОМ ОВТУЕВКЕУ МАМЕ { 
ОЪОМС СоппесЕ1оп1таех; 
ОТОМС Асбпа1Ъепаев; 
ЯСНАВ Ог1уетгКеуМапе [1]; 
} 95В_МОБЕ_СОММЕСТТОМ РВТУЕВКЕУ МАМЕ, 
*РИЗВ МОРЕ СОММЕСТТОМ ОВТУЕВКЕУ МАМЕ; 
// описание дескриптора 
суредеЁ эегасЕ _О5В_ЗТВТМС ОЕЗСВТРТОВ { 
ОСНАВ БТепаеЬ; 
ОСНАК ББезсг1реогтТуре; 
ЯСНАВК Ь5Етапа [1]; 
} 95В_5ТВТМС РЕЗСВТРТОК, *РОЗВ ЗТВТМС РЕЗСВТРТОК; 
// описание подключенного устройства 
суредеЁ эегасЕ _$ТВТМС ОЕЗСВТРТОВ_МОРЕ 
{ 
зЕгасЕ _ЗТВ1МС РЕЗСВТРТОВ МОРЕ *Мехе; 
ОСНАВ БезсгарфогТпаех; 
ОЗНОВТ Гапачзадето; 
95В_ЭТВТМС_ОЕЗСВТРТОВ 5&г1парезск1реог [0]; 
} ЭТВТМб РЕЗСВТРТОК_МОБЕ, *РЗУТВТМС РЕЗСВТРТОК_МОРЕ; 
// описание дескриптора хаба 
суреаеЕ з&гисЕ _О5В_ НОВ РЕЗСВТРТОВ { 
ОСНАВ рбезсг1реогЪераеВ; 
ОСНАВ БОезсг1реогТуре; 
ОСНАК Б№лирегОЕРоге$; 
ОЗНОВТ мНоБСВагас®ех1$*1с$; 
ОСНАВ БРочегОпТоРомегбооа; 
ОСНАВ БНиЮСопего1Сиггепе; 
ОСНАК БВепоуеАпаРометМазк [64]; 
} 05В НОВ РЕЗСВТРТОВ, *РОЗВ НОВ РЕЗСВТРТОВ; 
// дополнительная информация о хабе 
суреаеЕ зекисе _О5В_НОВ_ТМЕОВМАТТОМ { 
95В_НОВ ОЕЗСВТРТОВ НабОезсг1реог; 
ВООТЕАМ НобТзВазРомегеа; 
} ОЗВ НОВ_ТМРОВМАТТОМ, *РОЗВ_НОВ_ТМЕРОВМАТТОМ; 
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фуреаеЕ з&гисЕ _О5В_МТ РАВЕМТ_ ТМЕОВМАТТОМ { 
ОТОМС МатрехОЕТтфехЁасез$; 
} О5В МГ РАВЕМТ_ТМЕОВМАТТОМ, *РОЗВ МТ РАВЕМТ ТМЕОВМАТТОМ; 
// параметры драйвера устройства 
фуреаеЕ зегосЕ _О5В_НСР ОВТУЕВКЕУ МАМЕ { 
ОТОМС АсЕца1Шепа®в; 
ИСНАВ РхлуегКеуМапе [1]; 
} 05В_НСБ_ОВТУЕВКЕУ МАМЕ, *РОЗВ_НСР ОВТУБВКЕУ МАМЕ; 
// описание хаба 
суреаеЕ епиш _О5В_НОВ_ МОРЕ 
{ 
ОзЬНУь, 
ОзЬМТРагеп® 
} 95В_НОВ_МОГЕ; 


фуредеЁ зегисЕ _О$В_МОБЕ_ТМЕОВМАТТОМ 
{ 
0$В НОВ МОРЕ М№оаеТуре; 
оатой { 
ОЗВ_ НОВ ТМЕОВМАТТОМ НаБТиготтае1оп; 
О5В МТ РАВЕМТ ТМЕОВМАТТОМ М1РагепЕТпоттае1от; 
} &; 
} 05В МОРЕ _ТМЕОВМАТТОМ, *РОЗВ МОРЕ ТМЕОВМАТТОМ; 
// параметры устройства 
фуреаеЕ з&хосЕ _О5В_РЕУТСЕ РЕЗСВТРТОВ { 
ОСНАВ БЬепаев; 
ОСНАВ Б/езсх1ржогТуре; 
ОЗНОВТ Бса0$В; 
ОСНАВ Б,еу1сеС1аз$; 
ОСНАВ ЬШ/еу1себаюС1а$$; 
ОСНАВ Б,еу1сеРго&осо1; 
ОСНАВ БМахРасКкее$17е0; 
ОЗНОВТ 1аУепаог; 
ОЗНОВТ 1артодас&; 
ОЗНОВТ рсаБеу1се; 
ОСНАВ 1МапоРасфотег; 
ОСНАВ 1Рхоаас®; 
ОСНАВ 15ех1а1Мотрех; 
ОСНАВ БМоюСопЕ19оха&1оп$; 
} 05В ОЕУТСЕ ОЕЗСВТРТОВ, *РИЗВ_РЕУТСЕ РЕЗСВТРТОВ; 
// состояние соединения 
суредеЕ епим _О05В _СОММЕСТТОМ 5ТАТОЗ { 
Мореу1сеСоппес*еа, 
Реу1сеСоппес*еа, 
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Реу1сеГа11еЧЕпомега*1оп, 

Беу1себепега1ЕКа11оге, 

Беу1сеСач5еОуегсиггепе, 

Реу1семо$ЕпочапРомег, 

Реу1семо<ЕпочаПВапам1 ав 
} ОЗВ СОММЕСТТОМ $ТАТО$, *РОЗВ_СОММЕСТТОМ_ЗТАТОЗ; 
// дополнительная информация о подключенном устройстве 
ЕуредеЕ зегисф _О$В ЕМОРОТМТ ОЕЗСВТРТОВ { 

ОСНАВ БТепа®В; 

ОСНАВ БОезсг1реогТуре; 

ОСНАВ БЕпаро1пЕАдагез$; 

ОСНАВ БзАбфг1Биеез$; 

ОЗНОВТ м“МахРасКе*$127е; 

ОСНАВ БТпфегуа1; 
} О5В ЕМОРОТМТ РЕЗСВТРТОВ, *РОЗВ_ ЕМОРОТМТ РЕЗСВТРТОВ; 
СуредеЕ зегасе _О5В_РТРЕ ТМЕО { 

О5В ЕМОРОТМТ РЕЗСАТРТОВ Епаро1пе.езст1реог; 

ОТОМС Зсреао1е0ЕЕ5е%; 
} ОЗВ РТРЕ ТМЕО, *РОЗВ РТРЕ_ТМЕО; 
$уреаеЕ эЕгасЕ _05В МОБЕ СОММЕСТТОМ ТМЕОВМАТТОМ { 

ОТОМС Соппес&1оп!Ттаех; 

О5$В_ РЕУТСЕ РЕЗСЕТРТОК Реу1серезст1реог; 

ОСНАВК Соггеп&СопЕ1дага®1отУаще; 

ВООТЕАМ Томбрееа; 

ВООТЕАМ Пеу1сетТзНаь; 

ОЗНОКТ Беу1сеАЯагез$; 

ОТОС МаифегОЕОрепР1рез; 

Ч$В СОММЕСТТОМ $ТАТО$ СоппесЕ1оп${аеаз; 

О5В РТРЕ ТМЕО Р1рер1э5[0]; 


} О5В_ МОРЕ СОММЕСТТОМ ТМЕОВМАТТОМ, *РИЗВ_МОРБЕ_СОММЕСТТОМ _ТМЕОВМАТТОМ; 


// текущее состояние устройства 
фуреаеЕ эзегасеЕ _И$В_РЕЗСВТРТОВ ВЕОЧЕЗТ { 
ОТОМС Соппес®1опТлаех; 
5егасё { 
ОСНАВ БиВеадоезс; 
ОСНАВ ЮВеаоез%е; 
ОЗНОЕТ з\Уа1ое; 
ОЗНОВТ мТпаех; 
ОЗНОКТ мчТЪепдаЕВ; 
} ЗебарРаскее; 
ОСНАВ Рафа [0]; 
} 95В_РЕЗСВТРТОВ ВЕОЧЕЗТ, *РОЗВ_РЕЗСВТРТОК_ВЕООЕЗТ; 
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// общие параметры устройства 
фуреаеЕ зегасе 
{ 
РСНАВ НаБМапе; 
РОЗВ_ МОБЕ_ ТМЕОВМАТТОМ НарТпЕо; 
РОЗВ_МОБЕ_ СОММЕСТТОМ ТМЕОВМАТТОМ Соппесе1опТпЕо; 
РОЗВ_РЕЗСВТРТОВ_ВЕООЕЗТ СопЁ190е5с; 
РУТВАТМС ОЕЗСВТРТОВ МОШЕ 5%г1п90езсз; 
} ОЗВОЕУТСЕТМЕО, *РОЗВОЕУТСЕТМЕО; 
#ргадта раск () 


Теперь, когда все основные структуры данных определены, создадим новый 
класс для работы с устройствами, размещенными на шине ЦЗВ. Чтобы про- 
демонстрировать основные принципы программирования данного типа обо- 
рудования, рассмотрим два базовых метода, совмещенных в одном классе. 
Назовем наш класс озв и напишем его реализацию так, как показано в лис- 
тингах 23.9 и 23.10. 


` Листинг 23.9. Файл УЗВ.И 





// подключаем необходимые файлы 

#1ос1аае <об)Базе.|> 

#аос1аае <1п1ао1а.10> 

#1ос1аае <зеборар1.6> 

#1осТтаде "азбдеЕз.в" 

// произвольные константы 

#АаеЁпе ОЗВ_МАХ_НОВ 10 // максимальное число хабов 

#АеЁ1пе ИЗВ МАХ РЕУТСЕЗ 10 // максимальное число устройств 
#+АеЁлпе ОВ МАХ РВТУЕВ 10 // максимальное число драйверов 
// объявление класса 


с1а5$ 05В 
{ 
раБ11с: 
05В (); // конструктор 
—05В () { } // пустой деструктор 


// функции открытого интерфейса 
// получение общего числа найденных. устройств 
91$19пеа 1пЕ беЕСоцпЕВеу1сез (}; 
// общее число подключенных устройств 
ип$1о9пеЯ 1опд беЕСоппесееЧШеу1сез (); 
// получение имени устройства 
уо1А СезОг1уетМаще ( опз1апеЯ 11 пом, срахг* аг1уег); 
// получение имени корневого устройства 
у01А СехВооНаюМате ( ип$1дпеЯ 1пЕ пом, сраг* гооё ру); 
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// 


// получение идентификатора производителя 

ип51апеЯ $ПохЕ беЕУепаогТР ( ип51дпеа 11 пом); 

// получение идентификатора устройства 

ип$1апеа зрогф СееРкодасЕ ТР ( ппз19пеа 11 пом}; 

// получение номера версии устройства 

ип51апе эзВогЕ СефУегз1опМонрег ( ипз19пеЯа 11 пом); 

// получение строкового описания производителя устройства 
у0о14 сехУепЧогМате ( ипз1дпеа 11 пи, сВаг* уепаог); 

// получение строкового описания устройства 

уо1А СеЕРгоаасЕМаще ( ипз1опеЯ 1пЕ пом, сВаг* ргодмас®); 
// получение серийного номера устройства 

уо1А Сефбег1а1Мопрег ( ипз1дпеа 1пЕ пом, сваг* зег1а1); 
Боо1 Ореп/еу1се ( ип5191еЯ 1пЕ пом); // открытие устройства 
У01А С1озереу]1се (); // закрытие текущего устройства 

// получение данных о возможностях устройства 

роо1 Сезреу1сеСарз (); 

// установка нового параметра для устройства 

Роо1 ЗеЕЕеабсаге ( уо014* Чафа, ипз1апейЯ 1опд Чаба_1еп); 

// получение указанного параметра устройства 

Боо1 СееЁЕеабоге ( уо1а* Чака); 

// чтение данных из устройства 

Боо1 ВеаЧБафа ( сВаг* БаЕЁег); 

// передача данных устройству 

Боо1 их1ферафа ( сБах* РоЕЁЕег, ипз1апе 1опа БаЕЕег 1еп); 
расширенные функции для демонстрации второго метода доступа 
// получение имени устройства 

уо1а бефбеу1сеМате Ех ( ип519пеа 11е пам, срах* паме); 

// получение идентификатора производителя 

9151дпе зВогЕ бее\Уепаог Ех ( ипз1дпеа 1те пом); 

// получение идентификатора устройства 

\1$191е@Я зВотЕ СеЕРгодос® Ех ( ипз19пеа 11 пом); 

// получение класса устройства 

0031д0еЯ срах бе С1аз$з Ех ( ипз1апеа 11 пом); 

// получение адреса устройства 

0$1970е зроге СбефАадгезз Ех ( ап519пеа 1пе пом); 


рг1уафе;: 


// описатель устройства для первого метода 
фуреаеЕ з%&гас® 


{ 


9051апеЯ зпогЕ Уепаог_ ТО; 
ип$19пеЯ зВогЕ Ргодмас® 10; 
ип$1опеа эзНогЕ Уегз1опМаюрег; 
сВаг Беу1сеРа р [АМУЗТАЕ АВКАУ]; 
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сраг УепаогМате [МАХ РАТН]; 
саг РгоЧис®Мате [МАХ РАТН]; 
срваг Зег1а1Мопфех [50]; 
} ОЗВОЕУРАВАМ$, *РИЗВОЕХУРАКАМ5 ; 
// параметры устройства 
фуреЧеЕ зЕгоас® 
{ 
сБаг ПГеу1се {МАХ РАТН]; 
ип5$1апеЯ зПогЕ Уепаог; 
01519пеа зрогЕ Ргоаасе; 
и0$1дпеЯ сраг Зег1а] Мег; 
01$519пеа сраг Пеу1сеС1аз$; 
00519пе спаг Беу1себаЮС1аз$; 
ип51апеа сБаг МахРаске*$1те; 
1051апеа зроге Адаге5з; 
ип519пеа 1опд СоопЕОрепСраппе1; 
0$5В_ СОММЕСТТОМ_$ТАТИ$ 5фа®\5$; 
} ОЗВРОВТ, *РОЗВРОВКТ; 
// описатель устройства 
СуреаеЕ зегас& 
{ 
саг НаюМамще [МАХ РАТН]; 
уп$19пеа зрогЕ Адаге$$; 
Боо1 ЮТзНою; 
Боо1 Бомбрееа; 
и1$19пеа 1опд СоппеОрепСВаппе]1; 
О5В РЕУТСЕ РЕЗСВТРТОВ 9; 
95В_МОБЕ ТМЕОВМАТТОМ поае; 
05В СОММЕСТТОМ 5ТАТО$ $6 авеа$; 
} ОЗВОЕУТСЕ, *РИЗВОЕУТСЕ; 
// описатель устройства для второго метода 
суреаеЁ з®&гас® 
{ 
сваг Ог1УегМате [МАХ РАТН]; 
сРаг Воо*НоЮМане [МАХ_РАТН]; 
ОЗВОЕУТСЕ аеу[0$В_МАХ_ НОВ]; 
} ОЗВОВТУЕВРАВАМ$, *РОЗВОВТУЕВРАКАМ$, *ГРИЗВОВТУЕВРАВАМС ; 
// описатель возможностей устройства 
суредеЕ эЕгас® 
{ 
ипз1апеая зПогф ТпрасВуке!епаЕП; 
ип$1дпе@ зВогЕ ОпериЕВусефепа®и; 
0051апеЯ зРогЕ КеабогеВукеГепоаей; 
} ОЗВОАТАЗТАЕ, *РОЗВРАТАЗТОЕ; 
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// объявляем рабочие структуры 
ОЗВОЕУРАВАМ$ азЪ[9$В МАХ ОЕУТСЕ$]; 
ОЗВОВТУЕВРАВАМ$ агу[05В МАХ НОВ]; 
ОЗВРОВТ роге [9$В МАХ РЕУТСЕ$]; 
ОЗВОАТАЗТЕЕ ц$ю $12е; 
// объявляем переменные класса 
НАМОЬЕ м _ПОеу1се; // дескриптор устройства 
оо1 м ЮТзСбеЕРагам$; // данные для устройства по первому методу 
Боо1 м ЬТзСеёРагаизЕх; // данные для устройства по второму методу 
Боо1 м СопЁ1а0езс; // данные о конфигурации устройства 
оо] ш ЬТ5Сарз; // данные о возможностях устройства 
015191е4а 11 п оСоцпЕОеу1сез; // количество найденных устройств 
91519пеЯ 116 п _1СозпЕНЫУЮ; // количество хабов 
106 м 1СиггепеОреп)еу1се; // номер текущего открытого устройства 
ип$19пеЧ 1опд п _1СозпеОеу1сезСоппескеа; // число подключенных устройств 
// вспомогательные функции класса 
// определение параметров устройства по первому методу 
у01А _деЕ,еу1сезРагатз (); 
// определение параметров устройства по второму методу 
у014а _деебеу1сезРагатмзЕх (); 
// получение имени устройства 
сВаг* дееКеуМаме ( НАМОГЕ |ПОеу1се); 
// получение имени драйвера 
СВаг* десОхуКеуМаше ( НАМОШЕ БНою, оп$19пеЯ 1оп9 Соппесе1опТптаех); 
// конвертирование строки 
СРаг* м56г Ко бег ( РИСНАВ м56г); 
// получение имени корневого хаба 
сВаг* _деевооеНаБМаще ( НАМОТЕ НозЕСопего11]ег); 
// перечисление устройств, подключенных к хабу 
у01А _еглиаНоЮ0еу1сез ( сраг* Вар папе, 
РОЗВ МОБЕ СОММЕСТТОМ ТМЕОВМАТТОМ соппес® 1пРо, 
РОЗВ РПЕЗСВТРТОВ ВЕОЧЕЗТ сЕд, РУТВТМС РЕЗСВТРТОК МОБЕ поае, сваг* Чеу1се, 
ипз1апеа 11% 1паех); 
// перечисление портов 
У014 _епамНубРоге$ ( НАМОГЕ РНаб, опз1апея 1оп9 МамрегРоге$); 
// получение описателя конфигурации 
РИЗВ РЕЗСВТРТОВ ВЕОЦЕЗТ деЕСопЕ1а0езст1реог ( НАМОГЕ ВНаь, 
оп$1апеа 1опа Соппес®1опТпаех, ипз1дрей сраг Тпаех); 
// проверка типа описателя 
Боо]1 _Т50езск1реогз ( РИЗВ РЕУТСЕ ОЕЗСВТРТОВ Пеу1се, 
РИЗВ СОМЕТСИВАТТОМ РЕЗСВТРТОВ СопЁ14); 
// получение всех описателей 
РЭТВТМС РЕЗСВТРТОК_МОБЕ _де+А115%г1п90езсг1реогз ( НАМОТЕ ИНУЬ, 
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ип$1а9пеа 1оп9 СоппесЕ1опТпаех, РОЗВ РЕУТСЕ РЕЗСВТРТОВ Пеу1се, 
РОЗВ_СОМЕТСОВАТТОМ РЕЗСВТРТОВ СопЁ19); 

// получение имени внешнего хаба 
сВаг* _дефсЕххегпа1НоюМатме ( НАМОЬЕ рНаь, 

01$1дпеа 1опд Соппес&1опТтаех); 

// получение описателя 
РЭТВТМС РЕЗСВТРТОВ МОБЕ _де&$Ег1паОезсг1реохг ( НАМОШЕ ВНУЬ, 
ип$1апеа 1опа Соппес&1опТоЧех, ип$1дпе@ сВаг Тпаех, 

015191еа зВогЕ Гапдаадето); 
// получение описателя 
РУТВТМС РЕЗСВТРТОВ_МОРЕ _де&5$Ег1парезсг1реогз ( НАМОЬЕ ВНаь, 
и0$1апеа 1опа СоппесЕ&1опТпаех, ип$19пеЯ сраг Тпаех, 

ип51опеая 1опа СоспЕЪапаТО$, ипз1апея зВоге* ГапаТ0$, 

РЭТВТМС РЕЗСВТРТОВ_МОБЕ Моае); 

}; // завершение класса 


: Листинг 23.10. Файл УЗВ.срр 





#10с1о4е "5ЕЧаЁх.В" 
#$10с1оае "о5в.В" 
// реализация класса 
0$В :: О5В () 
{ 
// обнуляем переменные и структуры класса 
п Б15СефРагашз = ЁЕа]1зе; 
п Б15СееРагамзЕх = Ёа1зе; 
п СопЕ1а0езс = Еа13е; 
м Ю1Т5Сарз = Еа13е; 
п оСоцпе.еу1сез = 0; 
п 1СочпеНиь = 0; 
м _1СоупеБеу1сезСоплесееа = 0; 
т _ЮОеу1се = МОШ; 
п 1СиоггепеОреп,еу1се = -1; 
7егоМетогу ( &а$Ъ, з12еоЕ ( ОЗВОЕУРАВАМ$)); 
7егоМетогу ( &Агу, з12еоЕ ( ОЗВОВТУЕКРАВАМ$)); 
бегоМетогу ( &роге, за1хеоЕ { ОЗВРОВТ)); 
} 
у01а 95В :: деПеу1сезРагатз () 
{ 
ЗР РЕУТСЕ ТМТЕВЕАСЕ РАТА 4еу; 
РЗР РЕУТСЕ ТМТЕВЕАСЕ РЕТАТТ РАТА 4ефа11 = МОБ; 
НТОО АТТВТВОТЕ$ афг; 
НАМОГЕ ЬОеу1се = МОШ,, ЬТаРо = МЫ; 
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СТР 91а; 
10$ 1паех = 0; 
1опа гези1е = 01; 
ОМОВО $12е раЕЁег = 0, ге 512те = 0; 
СВаг БаЕ[МАХ_РАТН]; 
Боо1 1а5Е = ЁЕа1зе; 
// обнуляем структуру 
2егоМетогу ( &Чеу, 317е0Е ( ЗР РЕУТСЕ ТМТЕВЕАСЕ ПАТА)); 
// получаем глобальный идентификатор для всех устройств И5В 
Нар бееН1аби1А ( &9а1а); 
// получаем информацию для всех устройств 
ВТаЕо = бебор01беЕС1а:з0еуз ( &ди1а, МОБ, МОШ., ОТССЕ ТМТЕВЕАСЕГЕУТСЕ 
| ОТССЕ _РВЕЗЕМТ); 
// в случае ошибки, выходим из функции 
1Е ( БтаЕо == ТМУАБТО НАМОГЕ УАГОЕ) гебагп; 
// устанавливаем размер структуры перед использованием 
Чеу.сЬ51те = 512е0оЕЁ ( 5Р ПРЕУТСЕ ТМТЕВЕАСЕ РАТА); 
// перебираем устройства 
[ето 
{ 
// получаем информацию об интерфейсе устройства 
тез01Е = Зефорр1Епатреу1сеТпеетРасез ( БТпЁо, 0, &да1а, 1паех, 
&аеу); 
// если информация найдена 
1Е ( геза1е != 0) 
{ 
// определяем необходимый размер буфера для получения данных 
гези1Е = бебарр1Сбесреу1сеТпеехгЕасе ефа11 ( ВТпРо, &4еу, МОШЬ, 0, 
&517е роЕЁЕег, МОБ); 
// если ошибка, переходим к следующему устройству 
1Е ( !хезы) сопе1пме; 
// выделяем необходимый размер памяти для получения всех данных 
Чефа11 = 
// устанавливаем размер структуры 
Чека11->с6512е = з12еоЕ ( 5Р РЕУТСЕ ТМТЕВЕАСЕ РЕТАТТ, РАТА); 
// повторно вызываем функцию 
гез:1{ = Зебар01Сеебеу1сеТпкегЕасе ефа1] ( ПТпЁЕо, &Аеу, Чефа11, 
$12е риЕЁег, &хед 31те, МОШ,); 
1Е ( !гезу1е) // если ошибка 
{ 
1Е ( Ч9ефа11) Егее ( 4ефга11); // освобождаем память 
сопЕ1пие; // переходим к следующему устройству 
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// сохраняем путь к устройству для последующего использования 
зЕгсру ( а56 а аСозпЕБеу1сез].Беу1сеРаЬ, Чефа11->Оеу1сеРа®п); 
// открываем найденное устройство 
ПОеу1се = СгеафеЕ1]е ( Чдефа11->Беу1сеРа®\, 
СЕМЕВТС ВЕАГ|СЕМЕВТС ИВТТЕ, ЕТЬЕ ЗНАВЕ ВЕАР | ЕЕ ЗНАВЕ ИВТТЕ, 
{ .РЗЕСОВТТУ АТТВТВОТЕ$) МОГТ, ОРЕМ_ЕХТЗТТМС, 0, МИШ,); 
1Е ( ЮОеуфсе == ТМУАЬТО НАМОТГЕ УАТОЕ) // если ошибка 
{ 
1Е ( аеса11) Егее ( 4ефа11); // освобождаем память 
сопЕ1пие; // переходим к следующему устройству 
} 
// устанавливаем размер структуры НТОО АТТВТВОТЕ$ 
аег.512е = 512еоЕ ( НТО АТТВТВОТЕЗ$); 
// получаем основные параметры устройства 
Нлар безАеетг1рофез ( ЮОеу1се, баг); 
// сохраняем их для последующего применения 
55 [а оСоцпЕОеу1сез].Уепаохг_ТО = абг.УепаотТО; 
955 [м оСоцпеОеу1сез].РгоЧисе ТО = ак. РЕОЗОСеТО; 
9$Ь Па иСоцпЕОеу1сез].Уегз1опМонег = афг.Уегз1опМатфег; 
// получаем имя производителя 
Н1ар бееМапоРас®агег$г1па ( ПОеу1се, БаЁ, з4теоЕ ( РаЕЁ))}; 
зЕгсру ( чзЪ (а аСочпеОеу1сез].УепаогМате, БиЕ); 
$Ехсру ( БЕ, ""); 
// получаем наименование изделия 
Нар СееРгодисЕ$тг1па ( ЮОеу1се, БоЁ, эахеоЕ ( БаЕ)); 
зЕхсру ( 36 [а аСоипеОеу1сез].Ргодис&Маме, БаЕЁ); 
5Егсру ( раЕ, ""); 
// получаем серийный номер изделия 
Нар беЕбег1а1Мопфег$г1па ( ПОеу1се, БаЁ, з12еоЕЁ ( РаЕ)); 
5Егсру ( 956 Па аСочпЕБеу1сез] .Зег1а]Маиюег, Б0Е); 
5Егсру ( БЕ, ""); 
// закрываем устройство и освобождаем память 
СЗозеНапа1е ( Ю/еу1се); 
Етее { 4ефа11); 
п оСоцпеБеу1сез++; 
} 
} мр11е ( 1аз% = Еа15е); 
// освобождаем выделенную память 
Зесир01Оез&гоубеу1сеттЕо1$е ( ПТпЕо); 
// устанавливаем признак выполнения операции 
п 615СееРагамз = ©гое; 
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у014 05В :: _деЕОеу1сезРагамзЕх () 
{ 
НАМОГЕ РОеу = №0; 
сВаг* Воо&НаБМаше = МОШЬ; 
СВаг* Аг1луег = МОШ; 
спаг памше [16]; 
Е 1=0; 
// перечисляем все возможные драйверы 
Бог (1=0; 1 < О5В МАХ ОВТУЕВ; 1++) 
{ 
// форматируем корректное имя драйвера 
изрузпеЕ ( паше, "\\\\.\\НСО$%а", 1}; 
// открываем драйвер 
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НОеу = СгеафеЕ11е ( паме, СЕМЕВТС ИВТТЕ, ЕТЕ ЗНАВЕ МВТТЕ, 


МОТ, ОРЕМ_ЕХТЗТТМС, 0, МОЫ,}; 
// если ошибок нет 
1Е ( ЮОеу != ТМУАБТО НАМОГЕ_УАГОЕ) 
{ 
// получаем имя драйвера 
Ат1уег = _деЕКеуМаме ( пОеу); 
// сохраняем его для последующего использования 
5Егсру ( агу[1].Ру1уегМаше, аг1уег); 
// если необходимо, освобождаем память 
1Е ( Чглуег) С1оБа1Егее ( Яглуег); 
// получаем имя корневого устройства 
ВооЕНаБМаше = _дееВоо&НаБМаще ( В0еу); 
// если ошибок нет 
ТЕ (ВоофНаБМаме != МОШ,) 


_епамНаюбеу1сез ( Воо&НоюМатме, МОГТ, МОШ., МОШ., "ВооНаБ", 
1); // получаем все устройства на хабе 


И// сохраняем имя корневого хаба для последующего использования 


5Ехсру ( агу[1].ВоофНаюМаше, ВоокНиюМапе); 
С1о5еНап1е ( НОе\у); // закрываем драйвер 


} 
// устанавливаем признак выполнения операции 
п ЬТзбееРагамзЕх = ©гое; 
} 
у01а Ч5$В :: _епамНою,еу1сез ( спаг* Нар папе, 
РИЗВ МОБЕ СОММЕСТТОМ ТМЕОВМАТТОМ соппесе_1пРо, 
РОЗВ_РЕЗСВТРТОВ ВЕОСОЕЗТ сЁд, РУТВТМС РЕЗСАТРТОВ МОРГЕ поде, 
и1$1апеа 10 1пдех) 
{ 
РОЗВОЕУТСЕТМЕО 1пЕо = МО; 


сРах* Чеуасе, 
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НАМРЬЕ ВНУБ = ТМУАЪТО НАМОЬЕ УАШОЕ; 
сВаг* Чеу1се паме = МОШ; 
сваг Маше [512]; 
2001 гези1е; 
ип51алеЯ 1опд 51Вуеез = 0; 
// выделяем память для информационной структуры и обнуляем ее 
11Ео = ( РОЗВРЕУТСЕТМЕО) С}0ора1А11ос ( СРТВ, 
517теоЕ ( ОЗВОЕУТСЕТМЕО)); 
// если ошибка, переходим к обработчику ошибок 
1Е ( 1аЕо == МО) добо Еггог; 
// передаем данные в структуру 
1пРо->НабМаме = роб папе; 
1пЕо->СоппесЕ1отТиЕо = соппес® 1тЕо; 
1пЕо->СопЕ1арезс = сЁа; 
1пЕ0->5$%г1190езс$ = поае; 
// выделяем память для структуры 9$В МОБЕ ТМЕОВМАТТОМ 
1пЕо->НорТпЕо = ( РОЗВ МОРЕ _ТМЕОВМАТТОМ) С10Ьа1А11]ос( СРТВ, 
$12е0Е ( О5В МОРЕ ТМЕОВМАТТОМ)); 
// если ошибка, переходим к обработчику ошибок 
1Е ( 1аРо->НоБТоаРо == МОШ,) дофо Еггог; 
// выделяем память для имени хаба 
Чеу1се паме = ( РСНАВ) С61ора1А11ос ( СРТВ, 56г1еп ({ Боб паме) + 
э1теоЕ ( "\\\\.\\")); 
// если ошибка, переходим к обработчику ошибок 
1Е ( Чеу1се паме == МОТ.) добо Еггог; 
// создаем полное имя хаба 
$Егсру ( Чеу1се паме, "\\\\.\\"); 
зЕгсру ( Чеу1се паше + э1теоЁ ( "\\\\.\\") - 1, 1тЕо->НаБМапе); 
// открываем устройство 
БНОЬ = СгеафеР11е ( Чеу1се_паме, СЕМЕВТС УВТТЕ, ЕТЬЕ ЗНАВЕ МУКТТЕ, 
МОТ, ОРЕМ_ЕХТЗТТМе, 0, МОТ); 
// освобождаем память 
С1ора1Егее ( Чеу1се папе); 
// если ошибка, переходим к обработчику ошибок 
1Е ( БНоь == ТМУАТТО НАМОЬЕ_УАТОЕ) добо Еггог; 
// делаем запрос на устройство 
гези1Е = Беу1сетоСопего] ( ВНаБ, ТОСТЬ 0$В_СЕТ_МОБЕ_ТМЕОВМАТТОМ, 
1пЕ0о->НУБТиЕо, $12еоЕ ( 0$В МОРЕ ТМЕОВМАТТОМ), 1пЕо->НабтпЕо, 
$12еоЁ ( 93В МОРЕ ТМЕОВМАТТОМ), &21Вубез, МО); 
// если ошибка, переходим к обработчику ошибок 
1Е ( !геза16) добо Еггог; 
// форматируем полученные данные 
1Е ( соппесЕ 110) 
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изре1пеЕ ( Маме, " [Рога] ", соппесе_1пЕо->Соппесе1опТтаех); 
зЕгсае ( Маме, ": "); 

} 

е1зе 
Мате [0] = 0; 


1Е ( аеу1се) 
5Етсае ( Маме, Чеу1се); 
е1зе 
5Етсае ( Маме, 1пЕо->НоюМаце); 
// сохраняем имя хаба для последующего использования 
$Егсру ( Чгу[Зп4ех].Че\у[1п4ех] .Ноьмаме, Маце); 
// сохраняем параметры устройства 
1Е ( соппесЕ_ 110) 
{ 
ЯЧгу[1паех] .Чеу[1п4ех].Зфабаз = 
1пР0о->СопресЕ1оп1Тто->Соппес*1оп$ава$; 
Агу[1паех] .аеу[1п9ех].АЧЯгез5 = 1пЕо->Соппес®1опТпЕо->Бе\у1сеАЧЯагез5; 
Агу [1паех] .Зеу[1паех].ЮТзНаоь = 1пЕо->Соппесе 1опТтЕо->Бе\у1сетзНаь; 
Аху[1пдех].Чеу[1п4ех].БоибрееЯ = 1пЕо->Соппес1оп1тЕо->Гом$реед; 
Ягу[1пдех] .Чеу[1п4ех] .СоспЕОрепСваппе1 = 
1пЕо->СоппесЕ1оп1пЕо->МиифегОЕОрепР1рез; 
петшсру ( &Чгу[1п9ех] .Чеу[1п4ех].а, 
&1пЕо->Соппес&1оп1ТлЕо->Беу1серезсг1реог, з1теоЁ ( ОЗВРЕХТСЕ)); 
} 
// перечисляем порты для хаба 
_епммНабРогез ( БНоъ, 
1пРо->НарТпЕо->а .НоюТпЕогта1оп .НоББезсеуреог. БМииьехОЕРог® $) ; 
// закрываем устройство 
С1озеНапа}е ( ВБНоь); 
гекигп; // выходим из функции 
// обработка ошибок 
Еггог: 
1Е ( БНОЬ != ТМУАБТР НАМРЬЕ УАТОЕ) 
{ 
С1озеНапа1е ( ВНоь); 
БНоь = ОШ; 
} 
1ЁЕ ( заРо != МО) 
{ 
1Е ( 1аЕо->НаБМате != МОШ,) 


{ 
С]ора1Егее ( 1пЕо->НоБМаме); 
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{ 


Часть //. Общие методы программирования в И/паоии$ 


1пРо->НоЮМапе = МОШ;; 
} 
1Е ( лаЕо->НабтаЕо != МОБ) 
{ 
С1ора1Егее ( 1щЕо->НорТпРо); 
1оЕо->НаЮТтЕо; 
} 
С]оба]1Егее ( 1160); 
100 = МЫ; 
} 
1Е ( соппесе_1тЁо) С10Ба1Ргее ( соппесе 1пЕо); 
1Е ( са) С1ора1Егее ( сЁа); 
1Е ( поае != м0) 
{ 
РЗТВТМС РЕЗСВТРТОВ МОРЕ Мех; 
Чо { 
МехЕ = поде->Мехе; 
С]ора]1Егее ({ поае); 
поае = МехЕ; 
} \11е ( поае != МОБ); 


а 05В :: _епаюНобРогЕз ( НАМОЬЕ ЮНоь, ап519пеа 1опд МаифетРоге 5$} 


РОЗВ_МОБЕ_СОММЕСТТОМ ТМЕОВМАТТОМ соппесЕ 4пРо = МО; 
РОЗВ РЕЗСКТРТОВ_ВЕООЕ$Т сопЁ19 = МО; 
РЭТВТМС РЕЗСВТРТОВ МОРЕ з6к = МОБ; 
РОЗВРЕУТСЕТМЕО 1пЁо = МО; 
сваг* аглуег = М0; 
срах* Че\у1се = МО; 
свах Маше [512]; 
0151916 1опд 1т4ех; 
Боо1 геза1%; 
// определяем все доступные порты 
Еог ( 1п4ех = 1; 1паех <= №либегРоге$; 1п4ех++) 
{ 
ип$19пеЯ 1опд и1Вуез; 
// вычисляем размер данных 
ц]Вуфез = 31те0Е ( ОЗВ МОБЕ СОММЕСТТОМ ТМЕОВМАТТОМ) + 
$12еоЁ ( 03В_РТРЕ ТМРО) * 30; 
// выделяем память для информационной структуры 
соппесе_1пЕо = 
( РОВ МОБЕ СОММЕСТТОМ_ТМЕОВМАТТОМ) С1ора1А11ос ( СРТВ, 


91Вубе5); 
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// если ошибка, выходим из цикла 
1Е ( соппесЕ 1пЕо == МО) ьхеак; 
// определяем номер порта 
соппес® _1пЕо->Соппесе1опТпаех = 1таех; 
// делаем запрос для данного порта 
теза1Е = Реу1сетоСопехо1 ( ВНиъ, 
ТОСТЬ_О5В_СЕТ_МОБЕ_СОММЕСТТОМ ТМЕОВМАТТОМ, соппес® 1пЕо, ч1Вубез, 
соппесЕ 1пЁо, и1Вусез, &141Вубез, М№Ш,); 
// если ошибка 
ЗЕ ( !геза1&) 
{ 
С1ора1Егее ( соппесЕ 110); // освобождаем память 
сопЕ1пие; // переходим к следующему порту 
} 
// вычисляем число подключенных устройств 
1Е ( соппес® 1пЕо->Соплес&1оп$аба$ == Пеу1сеСоппес®ед) 
п_1СоцпеРеу1сезСоплескеа++; 
// вычисляем число хабов 
1Е ( соппес®_1пЕо->Беу1сетзНаЪ) 
м 1СоцпЕНаЮ++; 
// если устройство подключено, получаем описание 
Чеу1се = МОШ;; 
1Ё ( соппес® 1пЕо->Соппес&1оп5аеаз != Мобеу1сеСоппесеея} 
{ 
Чг1уег = _деергуКеуМате ( ВНу, 1п4ех); 
зЕтсру ( Чгу[1п9ех] .де\у->НоюМапе, @аг1уег); 
1Е ( аглуег) 61ора]Егее ( Чг1луег); // освобождаем память 
} 
// если устройство подключено, определяем его конфигурацию 
1Е ( м СопЕ1а0езс && 
соппес®_1пЕо->Соппесе1оп5аеаз$ == Реу1сеСоппескеа) 


п СопЕ1а0езс = _дееСопЕ1арезск1реог ( БНаб, 1таех, 0); 
} 
е1зе 
п СорЕ190езс = МОЩЬ; 
// получаем описатели устройства 
1Е ( м СопЕтарезс != МОБЬ && 
_Тзрезск1реогз ( &соппесе 1пЕо->0еу1серезск1реог, 
( РОЗВ СОМЕТСОВАТТОМ РЕЗСВТРТОВ) ( сопЕ19 + 1))) 
{ 
зЕг = _9е%А1135г1п9безск1реогз ( ВНаб, 1паех, 
&соппес®_ 1пЕо->Пеу1серезст1реог, 
{ ОЗВ СОМЕТСОВАТТОМ РЕЗСВТРТОВ) ( сопЁ1а + 1)); 
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е1зе 
56х = №; 
// если устройство связано с внешним хабом, получаем данные о нем 
1Е ( соппесе 1пЕо->Пеу1сетзНар) 
{ 
сраг* рНоБМаме = МОБ; 
рНУюМаме = _декЕхфегпа]НоБМате ( ВНоБ, 1п4ех); 
1Е ( рнаБМане != МОШЬ) // если хаб существует 
{ 
// перечисляем подключенные к нему устройства 
_епомНоб)еу1сез ( рНоЮМане, соппесё_1пЁЕо, сопЁ19, э6г, Че\м1се, 
1п4ех); 
сопЕ1пие; // переходим к следующему порту 


} 
// выделяем память для информационной структуры 
1пРо = ( РОЗВРЕУТСЕТМЕО) С1офа1А11ос ( СРТВ, 
512еоЕ ( ОЗВОЕУТСЕТМЕО})); 
// если ошибка, освобождаем ресурсы 
1Е ( 1аЕо == МОШ,) 
{ 
1Е ( сопЁЕ1а != МО, 
С]оба]1Егее (сопЁ1а); 
С1офа]Егее ( соппес®_ 10); 
Ьгеак; 
} 
// заполняем поля структуры полученными данными 
1пЕо->СоппесЕ1опТпЕо = соппесё 110; 
1пЕо->СопЁ19резс = сопЁ1а; 
1пЕо->5%:1па0езс5$ = 5%г; 
// форматируем имя порта 
изрг1пЕЕ ( Маме, "[РогЕ%а] ", 1пдех); 
1Е ( Чеу1се) 
{ 
эЕгсае ( Маме, " : "); 
5Етгса®( Маме, Чеу1се); 
} 
// сохраняем полученные данные для последующего использования 
5Егсру ( рог®[1п4ех] .Бе\у1се, Мапе); 
роге [1п4ех] .АЧагез5 = 1тЕо->Соппесе1опТпЕо->Реу1сеАаагез$; 
роге [1п4ех].СоипЕОрепСраппе] = 
1пЕо->Соппес 1опТпЕо->МоиюегОЕОрепР1 рез; 
роге [1п4аех] .Беу1сеС1аз$ = 
17лРо->СоппесЕ1оп1ТтЕо->Беу1серезск1реог . ЬБеу1сес1аз5; 


Глава 


} 
сВаг* 
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рог [1п4ех] .Беу1себЬС1а$$ = 
11Ео->Соплес®1опТпЕо->0еу1себезсг1реог .5)еу1се$6С1азз; 
роге [1паех] .МахРаскее$1хе = 
11Ео->Соппес&1опТпо->еу1серезсг1Ареог.ЬБМахРаскее512е0; 
рог [1п4ех] .Ргодисе = 
11Е0о->СоппесЕ1опТпЕо->0е\1серезсг1реог. 1АРгодисе; 
роге [1п4ех] .бег1а]Милег = 
101Ео->Соппесе1опТпЕо->Бе\у1серезсг1реог. 153ег1а1М№лфег; 
рогЕ [1п4ех] .5%$асаз = 1пЕо->Соппесе1оп1тЕо->Соппесе1оп$хаваз; 
роге [1паех] .Уепаог = 
11Е0->СоплесЕ1оп 1Ео->0еу1серезсг1реог . 1А\Мепаог; 
// освобождаем память 
С]ора1Егее ( 110); 


03В :: _декЕхегпа1НоБМане ( НАМОЦЕ  ВНоь, 
\7151а1е 1опд СоппесЕ1опТпаех) 
В МОРЕ СОММЕСТТОМ МАМЕ НоюМаме; 


РОЗВ_МОБЕ СОММЕСТТОМ МАМЕ НоБМате? = МОБ; 
сВаг* НаБМатме3 = МОГ; 

Боо] гезо1; 

\01519пеа 1опд и1Вуез$ = 0; 


// 


определяем размер данных для хранения имени хаба 


НаБМаме . Соппес®1опТпаех = Соппесе1оп1Тптаех; 


те 


ТОСТЬ О$В СЕТ МОРЕ СОММЕСТТОМ МАМЕ, &НиЮМапе, з1т2еоЁ ( НаБМаме), 


& 
// 
1Е 
// 
01 
// 
1Е 
// 


501Е = Беху1сеТоСойяего1 ( ВНаь, 


НаоБМмаме, эз12еоЁ ( НаЮМаме), &5о1Вубез, МОШ)); 

если ошибка, переходим к обработчику ошибок 

( !гези1е) дофбо Еггог; 

получаем размер в байтах для хранения имени хаба 
Вубез = НоБМапе.Аскпаа1ЩепаеВ; 

если ошибка, переходим к обработчику ошибок 

( 01ВуЕе$ <= $12еоЕ ( НабМаме)) добо Еггог; 

выделяем память 


НарМаме? = ( РОЗВ МОБЕ СОММЕСТТОМ МАМЕ) С1оБа1А11о0с ( СРТВ, 


// 
ЗЕ 
На 
// 


те 


и1Вубе5); 


если ошибка, переходим к обработчику ошибок 
( НоЮМаме? == МОШ,) добо Еггог; 
ЮМаше?->Соппесе1оп1Ттаех = Соппесе1опТтаех; 
получаем имя внешнего хаба 
5016 = Беу1сетоСопего1 ( ВНуь, 


ТОСТГ. 9$В СЕТ МОРЕ СОММЕСТТОМ МАМЕ, НоБМаще?, и1Вуфез, НаБМаме?, 


01Вубез, &а1Вубез, МОШ,); 
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// если ошибка, переходим к обработчику ошибок 
1Е ( !ге5о1®) добво Еггог; 
// конвертируем имя внешнего хаба 
НаБМате3 = _иЗег во пбег ( НаБМаме2->Модемане) ; 
// освобождаем память 
С]ора1Егее ( НобМаше?); 
// возвращаем имя внешнего хаба 
гесагп НабМапеЗ3; 
// обработчик ошибок 
Еггог: 
1Е ( НоюМаме? != МОЫ,) 
{ 
С1ора]Егее ( НобМапе2); 
НоБМапе? = МОШ; 
} 
тебагп МОГ; // завершаем функцию с -ошибкой 

} 

РУТВАТМС РЕЗСВТРТОК_ МОРЕ 0$В :: _чее$ег1па0езсг1реог ( НАМОГЕ  ВНоь, 
и1519пеа 1опд СоппесЕ1опТпаех, ипз1апеЧ сраг Тпаех, 
ип$19пеЯ зВоге Гаподаадетр) 

{ 

РОЗВ_РЕЗСВТРТОВ_ВЕООЕЗТ Веа МО; 
РОЗВ ЗТВТМС РЕЗСВТРТОВ з%х мор; 
РУТВТМС ОЕЗСВТРТОВ_МОРЕ Моде = МОШ:; 
Боо]1 гези1; 


ип$19пеЯ 1опа и1Вувез = 0, и1ВубезКебсагпеа = 0; 
915191е@ сраг ВеаВоЕ[ 512еоЕЁ ( 93В_РЕЗСВТРТОВ_ВЕОЧЕЗТ) + 
МАХТМОМ 95В_$ТВАТМС БЕМСТН]}; 
9]Вубез = з12еоЁ ( ВеаВоЕЁ); 
// инициализируем переменные 
Веа = ( РОЗВ ОЕЗСВТРТОВ_ВЕОЧЕЗТ) ВеаВиЕЁ; 
5Ег = ( РОЗВ_$ТВТМб РЕЗСВТРТОВ) ( Веа + 1); 
// обнуляем структуру 
пещзее ( Веа, 0, и1Вуее5); 
// указываем номер порта 
Веа->СоппесЕ1оп1Ттаех = Соппес&1оптаех; 
// инициализируем поля структуры 
Веч->5евирРаске®.м\а]1е = ( О05В $ТВТМб РЕЗСВТРТОВ_ТУРЕ << 8) | Тпаех; 
Веч->5екорРасКе®е.мТпаех = Гапдиадето; 
// вычисляем размер данных 
Веч->5еборРаскее.мЬепаев = ( ОЗНОВТ) ( о1Вувез$ - 
$12е0Е ( 95В ОЕЗСВТРТОВ_ВЕСОЕЗТ)); 
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} 


// делаем запрос для получения дескриптора 
геза16 = Бе\у1сеТоСопего1 ( ВНаь, 


ТОСТЬ 9$В_ СЕТ РЕЗСВТРТОВ_ЕВОМ МОРЕ СОММЕСТТОМ, Веа, и1Вуфез, Веа, 


0]Вубез, &0]ВубезВееатгпеа, МОШ,); 
// если ошибка, выходим из функции с ошибкой 
1Е ( !:е5а]16) гекагл МОШ; 
// если некорректный размер полученных данных 
// выходим из функции с ошибкой 
1Е ( о1ВукезВекогпеЯ < 2) гекагп МОШ; 
// если полученный дескриптор имеет неправильный тип 
1Е ( з5г->ЮБезсгуреогТуре != 95В_$ТВТМС РЕЗСВТРТОВ ТУРЕ) 
гебигл МОШ; // выходим из функции с ошибкой 
// если не совпал размер дескриптора 
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Е (56 г->ЮТепаёй != ч]ВубезВебагпеЯ - з12еоЕ (05$В_ РЕЗСВТРТОВ ВЕОЦЕЗТ)) 


тебогтп МОШ,; выходим из функции с ошибкой 
// если есть остаток 
1Е ( эвх->Ььепдев % 2 != 0) 
гебагп МОБ; // выходим из функции с ошибкой 
// выделяем память для сохранения дескриптора 
Мое = ( РЗТВТМб РЕЗСВТРТОВ_ МОШЕ) 6105а1А110с ( СРТВ, 


$12еоЁ ( ЗТВЛМС РЕЗСВТРТОВ_МОРЕ) + зЕг->ЬЬепаеП); 


1Е ( №ое == МОГ) // выходим из функции с ошибкой 

// заполняем выделенную память данными 
М№оде->Безсу1реох1птаех = Тпаех; 

Моае->Ьапацадетр = Гапацааетр; 

петсру ( №ае->5&г1па0езси1реог, $зЕг, зЕг->оГепоей); 
тегогп Моде; // возвращаем требуемые данные о дескрипторе 


РУТВТМС РЕЗСВТРТОВ_ МОРЕ О0$В :; _дефА115$%г1п9резск1реогз ( 


{ 


НАМОГЕ  БНоЬ, ыпз1дтей 1опа СоппесЕ1опТпаех, 


РОЗВ_РЕУТСЕ_ОРЕЗСВТРТОВ Реу1се, РОЗВ СОМЕТСОВАТТОМ РЕЗСВТРТОВ СопЕ1а) 


РУТАТМС РЕЗСВТРТОВ МОРЕ 1апдиадез = МОШ,; 
Р5ТВАТМС РЕЗСВТРТОВ_МОРЕ Моде = МОГ; 
РОЗВ_СОММОМ РЕЗСВТРТОВ соптоп = МОМ; 
01$19пеА 1опд соопЕЬапачадет!О$ = 0; 
ип519пеа зБогё* 1апаТО5 = М0Ш; 

07$191еА свахг* 1азё = МОШ; 

// получаем идентификаторы языков 


1ападоадез = дееЗег1парезск1реог ( ВНою, СоппесЕ1опТпаех, 0, 0); 


// если ошибка, выходим из функции 
1Е ( 1апдаадез == МОШ,) геогр МОШ; 


соопЕГапацаде!Тр$ = ( 1апападез->5%г1п90езск1реог->ЬБепаеВ - 2) 


/2; 
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1ап9Т0$ = &1апдоадез->5Ех1па0езсг1реог->55ех1та [0]; 
Мое = 1апддадез; 
// получаем описатели устройства 
1Е ( Реу1се->1МапаЁаскагег) 
{ 
Моде = _дее5Ег1парезсг1реогз ( ЮНаБ, Соппес®1оптпаех, 
Бе\у1се->1МапоЁасеагег, соипЕЬапазааетО$, 1апа1Оз, М№4е); 
} 
1ЁЕ ( Оеу1се->1Ргодас®) 
{ 
Моае = _деЕ5Ег1паОезсг1реогз$ ( ЬНоф, СоппесЕ1опТпаех, 
Реу1се->1Ргоассе, соопЕЬапацааеТО$, 1апаТОз, Моде); 
} 
1Е ( Беу!1се->1$ег1а1Мопфег) 
{ 
Моде = _деЕ5%г1парезсг1реог$ ( БНирю, Соппесе1опТпаех, 
Реу1се->1бет1а1Митбет, соипЕЬапааааетО$, 1апа{Оз, М№4е); 
} 
// определяем конфигурацию и описатель интерфейса 


1азЕ = ( РОСНАВ) СопЁЕ1а + СопЁ19->мТоба1Щепаей; 
соштоп= ( РОЗВ _СОММОМ РЕЗСВТРТОВ) СопЁ19; 
\р11е ( ( РОСНАВ) соптоп + $12еоЕ ( 958 _СОММОМ РЕЗСВТРТОВ) < 1а5% &8 


( РОСНАВ) соптоп + сопиоп->юБепаеВ <= 1а5%®) 


$иТЕСВ (сопиоп->6Безсг1реогТуре) 
{ 
сазе 05В СОМЕТСОВАТТОМ РЕЗСВТРТОВ ТУРЕ: // описатель конфигурации 
1Е ( сошпюп->6Бепаей != 512еоЕ ( О5В СОМЕТСОВАТТОМ РЕЗСВТРТОВ) ) 
ЬгеаК; 
1Е ( ( ( РОЗВ_СОМЕТСУВАТТОМ ОЕЗСВТРТОК) сопшоп)->1СопЕ1аатга1оп) 
{ 
// получаем описатели 
М№ае = _дее5Ег1т9Оезскареогз ( ВНоь, СоппесЕ1опТпаех, 
( ( РОЗВ_ СОМЕТСОВАТТОМ_РЕЗСВТРТОВ) соттоп)->1СопЕ1дага оп, 
соцпЕГапацадетТО$, 1апаТОз, Моае); 
} 
// увеличиваем общий размер прочитанных данных 
сопиюп += соппюп->оГепаев; 
сопЕ1пие; // переходим к следующему описателю 
сазе О$В ТМТЕВЕАСЕ ОЕЗСВТРТОВ ТУРЕ: // описатель интерфейса 
1Е ( сопиоп->ЮЬепаев != з12еоЕ ( О5В_ТМТЕВЕАСЕ РЕЗСВТРТОВ) && 
сопиюп->БЬепчеВ != 512еоЁ ( 05В ТМТЕВЕАСЕ РЕЗСВТРТОВ2)) 
Ьгеак; 
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1Е ( ( ( РО$ЗВ_ ТМТЕВЕАСЕ РЕЗСВТРТОВ) согтоп) ->1ТпбегЕасе) 
{ 
// получаем описатели 
Мое = _дее5ег1парезстуреог$ ( ВНауЮ, Соппесе1опТпаех, 
{ ( РОЗВ_ТМТЕВЕАСЕ_РЕЗСАТРТОК) сотоп) ->1ТпфетЕасе, 
сочпЕГапазадеТО$, 1апдТО$, Моае); 
} 
// увеличиваем общий размер прочитанных данных 
сопшюп += соптоп->5Шепа®й; 
сопЕ1пие; // переходим к следующему описателю 
// если описатель не имеет нужного типа 
ЯеЁат1 : 
// просто увеличиваем общий размер прочитанных данных 
сопшой += соштоп->Ьцепаеь; 
сопЕ1пце; // переходим к следующему описателю 
} 
Ьгеак; 
} 
// возвращаем описатель языка 
тефогп 1апазадез; 


РЭТВТМС _ОЕЗСВТРТОК МОРЕ О0$В :: _дее$г1паезст1реогз ( НАМОЬЕ  ВНоь, 
и1$19пеа 1оп9 Соппесе1опТп4ех, ип$1длеЯ свВаг Тпаех, 
ип$1опеа 1оп9 СозпЕЁБапаТ0$, ипз1дтеЯ зВоге* ГапаТО$, 
РУТАТМС РЕЗСВТРТОВ_МОРЕ Моае) 
{ 
и1519щеа 1опд 1; 
// вычисляем число описателей 
Бог (1=0; 1 < СоипЕТапаТОв; 1++) 
{ 
// получаем описатель 
Моде->Мехе = _дее5Ег1пабезсктареог ( ПНыю, Соппесе1опТпаех, Тпаех, 
*ТаподТ03з); 


1Е ( Моде->Мехе) // переходим к следующему 
{ 
Моде = М№оде->Мехе; 
} 
Тапа10$++; // увеличиваем счетчик 
} 


тесагп Моае; 
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6001 95В :: _ТзБезсг1реогз ( РОЗВ РЕУТСЕ ПЕЗСВТРТОВ Пеу1се, 
РОЗВ_ СОМЕТСУВАТТОМ РЕЗСВТРТОВ СопЁ19) 


0051апеЯ сраг* 1а5е = МОШ; 
РОЗВ_СОММОМ РЕЗСВТРТОВ сотой = МОШЕ; 
// проверяем корректность описателя 
1Е ( Реу1се->1МапаЕасеогег || Беу1се->1Ргодас® || 
Беу1се->1бег1а №\лрег) 
гебагп &гоае; 
// проверяем описатель конфигурации и интерфейса 


1азе = ( РОСНАВ) СопЁ1а + СопЕ1а->мТоба1Ъепаеи; 
сотоп = ( РУЗВ СОММОМ БЕЗСВТРТОВ) СопЁ19; 
ур11е ( ( РОСНАВ) сомтоп + $12еоЕ ( О5В СОММОМ РЕЗСВТРТОВ) < 1а5® && 


( РОСНАВ) сопоп + соптоп->ЬБепаейН <= 1а$%) 
{ 
$м1есв ( сомиоп->6Безст1реогТуре) // проверяем тип описателя 
( 
сазе ОЗВ СОМЕТСОВАТТОМ РЕЗСВТРТОВ ТУРЕ: // описатель конфигурации 
1Е ( сомтоп->ЬБепаеп != 512ео0Е ( 953В СОМЕТСОВАТТОМ РЕЗСВТРТОВ)) 


Ьгеак; 
// выполняем проверку 
1Е (( ( РОЗВ_СОМЕТСОВАТТОМ РЕЗСВТРТОВ) соптоп)->1СопЕ19ага®1оп) 


гебого $гое; 
// увеличиваем общий размер прочитанных данных 
соптоп += сопиоп->6ГепаеВ; 
соп&1пие; // переходим к следующему описателю 
сазе О5В ТМТЕВЕАСЕ РЕЗСВТРТОВ ТУРЕ: // описатель интерфейса 
1Е ( соитоп->ББераЕВ != 51теоЕ ( О5В ТМТЕВЕАСЕ РЕЗСВТРТОВ) && 
соитоп->5ШепаЕВ != 512еоЕ ( 95В ТМТЕВЕАСЕ РЕЗСВТРТОВ2)) 


Ьгеак; 
// выполняем проверку 
1101 ( РОЗВ ТМТЕВЕАСЕ РЕЗСВТРТОВ) соиоп) ->1Тп$егЁасе) 


гесагип 6гое; 
// увеличиваем общий размер прочитанных данных 
соптоп += сопиоп->ЬГепаеИ; 
сопЕ1пае; // переходим к следующему описателю 
// если описатель не имеет нужного типа 
ЯеЁао1*: 
// просто увеличиваем общий размер прочитанных данных 
соитоп += соитоп->ЪШепаей; 
сопё1п1е; // переходим к следующему описателю 
} 


Югеак; 
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гебогп Еа15е; 

} 

РО5В_РЕЗСВТРТОВ_ВЕОЧЕЗТ 95В :: _дееСорЕ190езсг1р®ог ( НАМОБЕ  ВНУБ, 
00519пеЯ 1опа Соппес®1опТидех, пипз1д0еЯ сваг Траех) 


РОВ РЕЗСВТРТОВ ВЕОЧЕЗТ Веа = МОШ; 
РОВ СОМЕТСОВАТТОМ РЕЗСВТРТОВ сопЕ19 = МО; 
Боо1 гезо; 
и15191еЯ 1оп9 о1Вуфез = 0, о1ВубезВебогпеЯя = 0; 
// вычисляем размер буфера 
91519теЯ спаг ВечВоЕ[512еоЕЁ ( 9$В РЕЗСВАТРТОВ ВЕОЧЕЗТ) + 
$17еоЁ ( 9$В_ СОМЕТСОКАТТОМ РЕЗСВТРТОВ)]; 
// определяем параметры для запроса описателя конфигурации 
0]Вубез = з1хеоЕ ( ВеаВоЕ); 
Вед = ( РОЗВ РЕЗСВТРТОВ_ВЕООЕЗТ) ВеаВаЕ; 
сопЁ1а = ( РОЗВ СОМЕТСОВАТТОМ РЕЗСВТРТОВ) ( Веа + 1); 
// обнуляем структуру 
шешзее ( Веа, 0, з1Вуфез); 
// указываем номер порта 
Веа->Соппес&1опТп4ех = СоппесЕ1оптпаех; 
// и значение по умолчанию 
Веа->5етарРаске{.мУа1ае = ( 95В СОМЕТСОВАТТОМ РЕЗСВТРТОВ_ ТУРЕ << 8} 
| Траех; 
// размер данных 
Веч->5ебарРаскее.мЬепоев = ( оп$19пеа эзВоге) ( и1Вубез - 
3з12еоЕ ( 05В_РЕЗСВТРТОК _ВЕОЧЕЗТ)); 

// получаем дескриптор конфигурации 
ге5о1& = Беу1сеТоСопего1 ( ВНУь, 

ТОСТ 95В_СЕТ_РЕЗСВТРТОВ_ЕКОМ_ МОРЕ _СОММЕСТТОМ, Веа, ч1Вуеез, Ве, 

01Вуфез, &а1ВусезВебогпеа, МО); 
// если ошибка, выходим из функции 
1Е ( !гезо1е) гебага №; 
// если получено не ожидаемое количество данных, выходим из функции 
1Е ( о1Вубез != о1ВубезВебогпеа) хебогп МО; 
// если не совпадает размер описателя, выходим из функции 
1Е (сопЕ1а->мТоба1Ъепаев < 512еоЕ (05В_СОМЕТСОВАТТОМ РЕЗСВТРТОВ)) 

тесаго №; 

// определяем параметры для получения полного описателя конфигурации 
51Вубе$ = 512е0оЕ ( 9$В_ РЕЗСВТРТОВ ВЕОЧЕЗТ) + сопЁ19->мТоба11епаен; 
// выделяем память 
Веч = ( РОЗВ РЕЗСВТРТОВ ВЕОЧЕЗТ) С1оБа1А11ос ( СРТВ, и1Вукез); 
// если ошибка, выходим из функции 
1Е ( Веа == МОШЬ) гебако МОБ; 
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// передаем указатель 
сопЁ19 = ( РОЗВ СОМЕТСОВАТТОМ РЕЗСВТРТОВ) ( Веа + 1); 
// указываем номер порта 
Веч->СоппесЕ1опТтаех = СоппесЕ1оп1Ттаех; 
// инициализируем поля структуры 
Веч->5есарРаске{ .мчУа1ае = ( 03В_СОМЕТСОВАТТОМ РЕЗСВТРТОВ_ТУРЕ << 8} 
| Траех; 
// вычисляем размер данных 
Веч->5есорРаскее.мЪепаеН = ( пп51апеЯ зВог®) ( 1Вубез - 
512еоЕ ( 05В РЕЗСВТРТОВ ВЕООЕЗТ)); 
// получаем описатель 
хези1е = Беу1сеТоСопего1 ( БНаь, 
ТОСТЬ О5В_ СЕТ РЕЗСВТРТОВ _ЕВОМ МОРЕ СОММЕСТТОМ, Веа, о1Вуфез, Ве, 
и]Вубез, &01ВубезВефоагпеа, №1}; 
// если ошибка, освобождаем память и выходим из функции 
ЗЕ ( !ге5о1{) 
{ 
С1ора1Егее ( Веа)}; 
гебахп МГ; 
} 
// если получено не ожидаемое количество данных, выходим из функции 
1Е ( и1Вусез != а1ВубезВебагпея) 
{ 
С1оБа1Егее ( Веа); 
гебагп МОБ; 
} 
// если не совпадает размер описателя, выходим из функции 
1Е (сопЕ19->мТоба]ТепаеВ != (а1Вубез - 
$12еоЕ ( 95В_ РЕЗСВТРТОВ _ВЕООЕЗТ) }) 


С1оБа1Егее ( Кеа); 
гебагп МОБ; 
} 
гебогп Веа; // возвращаем описатель конфигурации 
} 
сваг* О0$В :: _дееогуКеуМате ( НАМОГЕ ВНоь, 
ип5запеа 1опа Соппесе1опТпаех) 


Ъоо1 гези1{; 

и031д90еЯ 1опд и1Вуеез = 0; 

О5В МОРЕ СОММЕСТТОМ РЕТУЕВКЕУ МАМЕ аг1уегМапе; 

РИЗВ МОБЕ СОММЕСТТОМ ОВТУЕВКЕУ МАМЕ ак1уегМане? = МОМ; 
СВаг* Аг1уегМапе3 = МО; 
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// определяем размер данных для имени драйвера 
Яг1уегМаме .Соппес1опТоЧех = СоппесЕ1опТт4ех; // номер порта 
// делаем запрос 
гез1& = Бе\у1сеТоСопего1 ( ВНаь, 
ТОСТЬ О5В_СЕТ_МОГЕ_СОММЕСТТОМ ОВТУЕВКЕУ МАМЕ, &Чк1уегМаце, 
$512е0Е ( Чг1уегМаме), &Аг1уегМаме, 51хеоЁ ( Чг1уегМапе), 
&11Вубез, №); 
// если ошибка, передаем управление обработчику ошибок 
1Е ( !хезоф@) добо Еггог; 
// получаем необходимый размер буфера для данных 
0]Вубез = аг1луетМаме.Асеоа11епоа®В; 
// если размер меньше требуемого, переходим к обработчику ошибок 
1Е ( а1Вубе$ <= з1теоЕЁ ( Чг1уетМале)) дофо Еггог; 
// выделяем память 
ЧглуегМаме? = 
( РОЗВ МОРЕ СОММЕСТТОМ ОВТУЕВКЕУ МАМЕ) 61ора1А110с ( СРТВ, 1Вусез); 
// если ошибка, передаем управление обработчику ошибок 
1Е ( аглуегМаме? == МОБ) дофо Еггог; 
// указываем номер порта 
Яг1уегМате?->Соппес 1опттаех = СоппесЕ1опттаех; 
// получаем имя драйвера 
ге5\21& = Беу1сетоСопего ( ВНаь, 
ТОСТЬ ЗВ СЕТ МОРЕ СОММЕСТТОМ ОВТУЕВКЕУ МАМЕ, Яг1уехМаме?, и1Вукез, 
Яг1уегМаме?2, 01Вубез, &о1Вувез, МО); 
// если ошибка, передаем управление обработчику ошибок 
1Е ( !гезоЁ) дово Еггог; 


// конвертируем полученное имя 
Чг1уегМате3 = _м5&г $0 пбег ( Чг1уегМате2->рг1уегКеуМаме); 
// освобождаем память 
С1ора1Етее ( Яг1уегМаме2); 
// возвращаем полученное имя драйвера 
гефагп Чг1УуегМапе3; 
// обработчик ошибок 
ЕГГОГ: | 
1Е ( агфуеМаме? != №1) 
{ 
С1ора1Егее ( Яг1уегМаме2); 
Яг1уегМаме? = МЫ; 
} 


гефагп М№ОЬЬ; // завершаем функцию с ошибкой 
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срах* 95В :; _деевооНаюМате ( НАМОГЕ НозЕСопего11ег) 
{ 
Боо1 гез\а1*; 
\10$19реа 1опд 01Вубез = 0; 
сраг* НабМате3 = МОБИ; 
95В ВООТ НОВ МАМЕ НоуБМапе; 
РИЗВ ВООТ НИВ МАМЕ НаБМапе? = МО; 
// получаем требуемый размер буфера 
гез01Е = Оеу1сеТоСопЕгоф ( НозеСопеко1Тек, 
ТОСТЬ 9$В СЕТ ВООТ НОВ МАМЕ, 0, 0, &НоБ\ате, з12еоЕЁ ( НаБМапе), 
&11Вубез, МО); 
// если ошибка, передаем управление обработчику ошибок 
1Е ( !хезо1е) дофо Вггког; 
// получаем необходимый размер буфера для данных 
и1ВуЕез = НабМапе.Асеаа1еро®В; 
// выделяем память 
НобМате? = ( РОЗВ ВООТ НОВ МАМЕ) 610ра1А11ос ( СРТВ, и1Вукез); 
// если ошибка, передаем управление обработчику ошибок 
1Е ( НаБМате? == МОБ) дофо Еггог; 
// получаем имя хаба 
гез16 = Беу1сеТоСопехго1 ( Ноз&Сопеёгоекг, 
ТОСТТ, 05В СЕТ ВООТ_НОВ МАМЕ, МОГ, 0, НабМане?, о1Вусез, 
&01Вубез, №); 
// если ошибка, передаем управление обработчику ошибок 
1Е ( !ге$о1%) дофо Егког; 





// выполняем конвертирование строки 
НоюМаще3з = _\м56хг $о та5ег ( НаБМаме?->ВоокНоБМате); 
// освобождаем память 
С1ора1Егее ( НабМапе2); 
// возвращаем имя хаба 
гефаго НобМате3; 
// обработчик ошибок 
Еггог: 
1Е ( НоюМате? != М9) 
{ 
С1ора1Кгее ( НобМапе2); 
НаБМаще? = МО; 
} 
гебагп МОМ; // выходим из функции с ошибкой 
} 
срах* Ч5В :: дееКеуМате ( НАМОТЕ ПОеу1се) 
{ 
Боо1 гезо1е; 
10$190еЯ 1юпд 01Вубез = 0; 
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СВаг* Чг1уегМамеЗ3 = МОШ;; 
95В_ НСР ОВТУЕВКЕУ МАМЕ аг1уегМаме; 
РО5В_НСР_ОВТУЕВКЕУ МАМЕ Чг1уегМане? = МОШ; 
// определяем размер буфера данных 
геза1{ = Беу1сеТоСоп®$го ( ВБеу1се, 
ТОСТЬ СЕТ_НСР ОВТУЕВКЕУ МАМЕ, &Аг1уетМате, 51теоЕ ( Яг1уегМапе), 
&аг1уегМале, $12е0оЁ ( Чг1уегМаме), &а1Вубез, МО); 
// если ошибка, передаем управление обработчику ошибок 
1Е ( !гезо1$) дофо Еггог; 
// получаем необходимый размер буфера для данных 
0]Вубез = аг1уегМаме.Асбаа]ТепаеН; 
// если полученный размер меньше требуемого 
// передаем управление обработчику ошибок 
1Е ( о1Вубез$ <= з1хеоЁ ( аг1уегМапе)) дофо Еггог; 
// выделяем память 
Чг1уегмаме? = ( РОЗВ НСР РЕТУЕВКЕУ МАМЕ) С1оБа1А11ос ( СРТВ, 
11Вубе5); 
// если ошибка, передаем управление обработчику ошибок 
1Е ( агзуегМаме? == МОТ) до®о Еггог; 
// получаем имя драйвера 
геза1Е = Оеу1сетоСопегоф ( пОеу1се, ТОСТГ СЕТ_НСР РВТУЕВКЕУ МАМЕ, 
Яг1уегМаме?, 01Вубез, Чаг1уегМаме?, 01Вубез, &101Вубез, МОШ.); 
// если ошибка, передаем управление обработчику ошибок 
1Е ( !гезо1е} добо Еггог; 
// выполняем конвертирование строки 
Чг1уегМате3 = м5%г бо бег ( Чг1уегМане?->0г1уегКеуМапе); 
// освобождаем память 
С1ора1Егее ( аг1уегМаме2); 
// возвращаем имя драйвера 
гесагп аг1уегМапе3; 
// обработчик ошибок 
'Егког: 
1Е ( ЧглуетМане? != МОШ,) 
{ 
С1ора1Егее (аг1уегМапе2); 
Яг1уегМаме? = МШ;; 
} 
гебаги МОБ; // выходим из функции с ошибкой 
} 
сваг* О5В :: _м56г $0 бег ( РИСНАК мег) 
{ 
\и13190е4 1опд а1Вукез = 0; 
спаг* ш5ег = М; 
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// определяем длину конвертируемой строки 
ц1Вубез = И1АеСвагТоМи161Вуке ( СР_ АСР, 0, м5Ег, -1, МОП, 0, МОШ, 
моьь); 

// если ноль, выходим из функции 

1Е ( о1Вубез == 0) гебаги МО; 

// выделяем необходимый размер памяти 

м$Ег = ( РСНАВ) С1оБа1А11ос ( СРТВ, и1Вуез); 

// если ошибка, выходим из функции 

1Е ( п5ег == МОШ.) гебаго №; 

// выполняем конвертирование 

91Вубе5 = И1АеСвагТоМо11Вубе ( СР_ АСР, 0, иЗег, -1, ш5ег, о1Вубез, 

МО, №); 

// если ошибка, освобождаем память и выходим из функции 

1Е ( о1Вубез == 0) 

{ 

С1оБа1Егее ( м5%г); 
гебагп МО; 

} 

гебагп м5ег; 
} 
// реализация открытых функций класса 
уо1а 9$В :: СееРгкодисЕМате ( ип$19дпеа 1пЕ пищ, свахг* ргоаис®) 
{ 

1Е ( на БТэбеЕРагатз) _дефреу1сезРагамз (); 

1Е ( гм > м оСочпЕБеузсез$) гебагп; 

зЕгсру { ргодас®, чазЪ [тим] .Ргодис®Мапе); 
} 
уо1а 95$В :: бебзех1а1Мабег ( пп$1а0еЯ 1пЕ пом, сваг* зегла1} 
{ 

1Е ( м 51збеерРагатз) _дееОеу1сезРагатз (}; 

1Е ( па > м оСочпе0еу1сез} хебагп; 

з6гсру ( зег1а1, азЪ[пим].Зег1а]М№иьег); 
} 
уо1а ОЗВ :: Сбеб\УуепаогМате ( опз1дпеЯ 1пе пим, сБаг* уепдог) 
{ 

1Е ( а РТзбееРагамз) _деереу1сезРагатз (}; 

1Е ( пам > м аСоупеОеу1сез} гебогп; 

зегсру ( уепаог, из [пи] .УепаогМаме}; 
} 
ип51апеЯ звохЕ 0$В :: СбебУуегз1оп№абехг ( оп5$1дпеа 11 пам) 
{ 

1Е ( на БТэбеЕРагатз) _декреу1сезРакатз (); 

1Е ( пм > м оСомпЕОеу1сез) гебоагр ОГ; 
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гевого 0$ [пом] .Уег51оп№ифег; 
} 
опз1апея 1106 05В :; бееСбопоеБеу1сез (} 
{ 
1Е ( 'щ БТэбезРагатз) _деереу1сезРагатз (); 
хебоги п чСоцпЕРеу1сез; 
} 
005190еЯ 1опд Ч95В :: бееСоппесееЯ.еу1сез () 
{ 
1Е ( м БТзбееРагатзЕх) _деЕреу1сезРагатзЕх (); 
гесоги ш_1СоцпЕРеу1сезСоппессеа; 
} 
10$19пеЯ $зВогЕ 95В :: беЕРкочасЕТр ( ап51дпеа 11 пит) 
{ 
1Е ( м 515бефРагамз} _дезреу1сезРагатз (); 
1Е ( пам > м оСочпЕОеу1сез} гебаги 01; 
гебаги 56 [пла] . РеоЧисЕ ТО; 
} 
и15191еЯ зрогё О5В :: СесУепаог"ТО ( чпз1дреЯ 10 пом) 
{ 
1Е ( м БТзбебРагатз} _де{реу1сезРагатз (); 
1Е ( пам > м оСочпЕОеу1сез) гебаги 01; 
гебаги озЪ [пил] .Уепаокг ТО; 
} 
уо1А 95В :: бебре1уегМаше ( ипз1дреЯя 116 пам, сваг* аг]уег) 
{ 
1Е ( ма БТэбезРагатзЕх) _деереу1сезРагатзЕх (); 
1Е ( па > м КочпЕБеу1сезСоппесеея) гебогп; 
зЕгсру ( ЯЧг1уег, агу[пом] .ОгзуегМапе); 
} 
у01а 95В :: бебвоосНаБМате ( апз1дпеЯ 11 пиш, сваг* гоо& ваЬ) 
{ 
1Е ( на Б15безРагатзЕх) _декреу1сезРагамзЕх (); 
1Е ( пам > м 1СоцпЕБеу1сезСоппесеея) гебогп; 
$Егсру ( гоо® паб, аку [пм] .ВоосНибМапе); 
} 
уо1А 95В :: бесреу1семате Ех ( ипз1дпея 1тЕ пит, сваг* папе) 
{ 
1Е ( м ЬТзбебРагатмзЕх) десреу1сезРагатзЕх (); 
1Е ( па > м 1СомпЕБеу1сезСоппесеея} гебоагп; 
зЕгсру ( паме, рог [пит] .Ре\у1се); 
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01319теЯ зпоге 93В :: СбебУепаог Ех ( ипз19теа 118 пам) 
{ 
1Е ( Ма ОТзбееРагатзЕх) деереу1сезРагамзЕх (); 
1 ( пм > м 1СоупеБеу1сезСоппесеея) гебаки От; 
тебагп роге [пом] .Уепаог; 
} 
и031апеЯ зВохгЕ 9$5В :: бееРгодасе_Ех ( ап$1апеЯ 11 пи) 
{ 
1Е ( а Б15беёРагатзЕх) _деереу1сезРагамзЕх ()}; 
1Е ( пам > м 1СочпЕеу1сезСоппесеея) гебаки 01; 
гебатгп рог® [пит] .РгоЧас®; 
} 
003191еЯ спаг О5В :; бееС1азз_Ех ( чп51отпеа 11 пла) 
{ 
1Е ( м БТзбеёРагатзЕх) _деебеу1сезРагамзЕх (); 
1Е ( пла > м Топ еу1сезСоппесеея) гебоги 01; 
тебаго рог® [пом] .Пеу1сеС1азз; 
} 
051д0еЯ зпогЕ 95В :: бекАаагезз Ех ( ипз1дпея 11 пом) 
{ 
1Е ( 'м 615беёРагатзЕх) _деОеу1сезРагатзЕх (); 
1Е ( па > м ККопреБеу1сезСоппесееЯ) гебаги 01; 
гебогр рог® [пом] .АЯЯге$$; 


} 


Боо1 95В :: Орепреу1се ( пр$1дпея 1 пом) 

{ 
1Е ( м ОТэзбебРакгамз) _дезреу1сезРагамз (); 
1Е (м ПОеу1се != МОШ,) гебагп Еа1зе; 


НАМОЬЕ ВОеу1зсе = МО; 
// открываем устройство 
п РОеу1се = СгеафеЕ11е ( 55 [пом] .Реу1сеРаеВ, 
СЕМЕВТС ВЕАР | СЕМЕВТС МВТТЕ, ЕТЬЕ ЗНАВЕ ВЕАО | ЕГЕ_ ЗНАВЕ_МВТТЕ, 
( ГРУЕСОВТТУ АТТВТВОТЕ$) МОГ, ОРЕМ ЕХТЗТТМС, 0, №11); 
3Е ( м ВОеузсе == ТМУАЬТО НАМОГЕ_УАГОЕ) 
{ 
м ПОеу1се = №11; 
гебого Ра15е; // не удалось открыть устройство 
} 
// устанавливаем номер текущего открытого устройства 
м 1СаггепеОрепреу1се = пит; 
// выходим из функции 
тебаги $гое; 
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уо1а Ч5В :: С1о5ереу1се () 
{ 
1Е ( м ВОеу1се == №1) 
гебагп; 
е15е 
{ 
С1озеНапа1е ( м ВОеу1се;}; 
м 1СаггепЕОрепреу1се = -1; 
п 515Сарз = Ёа15е; 
м ПОеу1се = М9; 


} 
Ъоо1 Ч95В :: беЕреу1сеСарз () 


{ 
1Е ( (м ВОеу1се == МОБ) || ( м 1СаггепеОрепреу1се < 0)) 


гебагп Еа15е; 
РНТОР_РВЕРАВЗЕР ПРАТА Рафа = МО; 
НТОР_САРЗ Сарз; 
2егоМещогу ( &Сарз, 512еоЁ ( НТОР_ САР5)}; 
2егоМеногу ( &а5Ъ6 517е, 512еоЕ ( ОЗВОРАТАЗТАЕ)); 
1Е ( !Н1ар бефРгерагзеЯрака ( м ПОеу1се, &ПРафа)) 
гебагп Еа1зе; 
1Е ( Нзар бееСарз ( Раба, &Сарз) != НТОР_$5ТАТО$ $0ССЕ55) 
гебагп Еа15е; 
и5Ъ з12е.ЕГеаагеВукеепаЕВ = Сар5.ЕКеасагеВерог(Вусецепаей; 
и55_512е. Тира ВусегепаеВ = Сарз.ТпроВерог(ВуеепаеН; 
и8Ъ_512е.ОпЕриасвВусерепдаЕЙ = Сарз.ОпериеВерогеВусеепаеп; 
п _Ь15Сарз = Егае; 
Нар РгееРгерагзеЧРафа ( Рафа); 
гесагп &гое; 
} 
Ъоо1 93В :: бесКеабаге ( уо14* Дафа) 


{ 


1Е ( (м БОеу1се == МОШ,) || ( м _1СоггепеОрепреу1се < 0) || 
н1.ЪТ$Сарз) гебагп Ёа1зе; 
1Е ( !Зафа) гебогп Еа15е; 


1Е( !Н1ар бесЕеабаге ( м НОеу1се, &Чаба, а5Ъ 512е.ГеабогеВукегепа®И)) 
гебогп Га15е; 
гебагио гие; 


} 
Ьоо1 О5В :: бееКеакаге ( \014* Часа, ипз1дпеЯ 1опд Чаба_1еп) 


{ 
1Е ( (См ВОеу1се == №.) || ( м 1Соггеп&Орепреу1се < 0) || 


10 ЪТ5Сар$) гебоагп Ёа15е; 
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и1$1дщеЯ зНохе 1еп = 0; 
1Е ( Чаба_1еп < ч5Ь з12е.РГеакагеВусеЪепаи) 
1еп = 95 312е.ЕеакигеВусеьепаеН; 
е1зе 
1еп = даба_1еп; 
1Е( !Н1ар бескеабиге ( м ПОе\у1се, Чафа, 1еп)) 
хебигп Еа1зе; 
хебиуп &гие; 
} 
Ъоо1 Ц5В :: Ик1берафа ( сваг* БаЕЁег, ипз1дпеа 1опд БаЕЁег _1еп)} 
{ 
ЗЕ ( (м ВОеузсе == МОШ) || ( м 1СагтепЕОрепреу1се < 0} || 
' ЪТ$Сарз) гебогп Ёа1зе; 
ЗЕ ( 'БаЕЕег || БаЁЕег_1еп > ч3Ъ 312е.ОпёриеВуегепа® п} 
хебигп Еа15е; 
ОМОВО амвВусезИг1е = 0; 
1Е ( Их беЕ11е ( м ПОеу1се, БаЕЕег, 3Ъ_ 312е.ОпЕрисВукегепоей, 
&ЧмВутезИхг1ее, М) 


гебиги Еа15е; 
} 
тебагд гие; 
} 
Ъоо1 И5В :: ВеаЧРафа ( свахг* ЪаЁЕег) 
{ 
1Е ( (м ВОеу1се == МОШ.) || ( м 1СаггепОрепреу1се < 0) || 
1 Ъ5Т5Сарз) гебагп Ёа1зе; 
1Е ( 'Ъ4ЕЁехг || зёх1еп ( БаЕЁег) < чзЬ $12е.тарисВусеьепаен} 
хебохгп Еа15е; 
РМОВР амВусезВеаа = 0; 
НАМОЬГЕ ВЕуепе = СгеабеБуепе (МО, 6тгое, $гае, МО); 
1Е ( ВЕУепе == МОШ.) хесохпо Ёа1зе; 
ОУЕВЬАРРЕО о; 
о.ОЕЁзее = 0; 
о.ОЕЁзеЕНаай = 0; 
о.ВЕхепЕ = ВЕмепе; 
1Е( !ВеааЕ11е ( м ВОеу1се, БаЁЕег, 36 $12е.ТприкВукетепаей, 
&аиВуезКеаа, &0)})} 


ОМОВО 4мВези1е = Иа1{Рог51191е06)]есф ( ВЕхепе, 3000); 
$и1Еср ( амВезо{) 
{ 
сазе МАТТ ОВОЕСТ_ 0: 
Ъгеак; 
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сазе МАТТ ТТМЕООТ: 
Сапсе1То ( м ВОеу1се); 
ВезекЕуепр® ( БЕуер{); 
С1озеНарЯ1е ( ВЕуепф); 
ВБЕуере = МОБ; 
тебогр Га15е; 


} 

ВезекЕуеп* ( НЕуер®); 

С1озеНапЧ1е ( ЮЕуер®); 

БЕуепе = МО; 

1Е ( !СефОуег1арредВези1 ( м РОеу1се, &о, &мВусезВеаа, Га15е)) 
тебогп Еа]15е; 

тебагпр &гоае; 


Реализация поддержки устройств ЦЗВ в представленном классе осуществля- 
ется двумя способами: посредством набора функций менеджера установки 
устройств и с помощью универсальной функции ввода-вывода РеузсетоСоп- 
$го1. Рассмотрим каждый из них более подробно. 


В первом случае вызывается функция _деереу1сезРагатз. Она находит все 
устройства определенного класса и выделяет их основные параметры (иден- 
тификаторы производителя и изделия) для дальнейшего доступа. Чтобы яв- 
но указать класс ОЗВ-устройств, мы применили специальную функцию 
НЗар беен1абиза, которая предназначена для определения уникального гло- 
бального идентификатора (сотр), поддерживающего все устройства с интер- 
фейсом Ч$В. Далее мы передали сотр в функцию зефаррасеес1аззПеуз 
для получения информации об устройствах указанного класса (в нашем 
случае 958). На следующем этапе, периодически вызывая функцию 
Зеёирр1Епитреу1сетосегЕасез, определяем параметры всех имеющихся в 
системе ЧЗВ-устройств. Для этого дополнительно применяем функцию 
Зерар01Се+реу1сеТпфегЕасере{а11. Главная ее задача состоит в возвращении 
пути к найденному устройству. Используя путь, открываем устройство 
{с ПОМОЩЬЮ СгеафеЕ11е) и получаем основные параметры посредством 
функции нар бекАсетг1Ьиеез. Дополнительно обрабатываем информацию о 
производителе и серийном номере устройства (нзар сееМапоЕаскакег Е к1ла, 
Нар беёРгодисе5ег1па И Н1АР бефЗег1а1Мильег5%г10а). И, в завершение, за- 
крываем текущее устройство и переходим к поиску следующего. Когда все 
устройства найдены, мы можем приступать. к непосредственной работе с 
ними. Сначала следует проанализировать возможности устройства, особен- 
но если вы планируете выполнять обмен данными. Эта задача решается в 
функции сефкреу1сесарз. Вызываем Н1ар СееРгерагзеЯрака (предварительная 
подготовка данных об устройстве) и в случае успешного завершения опре- 
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деляем непосредственно поддерживаемые устройством возможности 
(НЗАР СекСарз). В данном случае нас интересуют только три параметра: раз- 
мер данных для управления свойствами устройства (геахигекерогЕВуеьета В), 
минимальные размеры в байтах входного (тпроЕВерогЕВусеьерс В) и выход- 
ного (ОцериЕВерогЕВуеетепаЬ) буферов для обмена данными. Для получения 
и установки свойств используются соответственно функции Н1ар сбееЕеакиге 
И Н1ар ЗееЕеакиге. Обмен данными с устройствами Ч$В осуществляется с 
помощью стандартных файловых функций \!1п32: веаЧЕ11е И Иг1кеЕ11е. Вот, 
в принципе, и все базовые сведения. Естественно, для организации переда- 
чи или приема данных необходимо иметь представление о применяемом в 
Ч$В протоколе и правилах форматирования последовательности байтов. 
Получить эту, а также другую полезную информацию о шине Ч$В можно, 
обратившись по адресу чуму. и$Ъ.огр. 


Второй способ основан на использовании функции реу1сетоСопего1. Прин- 
цип работы этой функции базируется на прямом взаимодействии програм- 
мы и устройства (драйвера) посредством специальных управляющих кодов. 
Например, для сброса порта Ч$В служит код ТОСТЬ ТМТЕВМАЬ ОЗВ_ВЕЗЕТ_РОВТ. 
Полный список всех поддерживаемых кодов можно посмотреть в файле 
и$Б1осИ.Н, входящем в состав пакета ООК. 


В любом случае показанный выше пример класса не охватывает и половины 
всех возможностей интерфейса ЧЗВ, но дает общее представление о мето- 
дах разработки программ для данного типа устройств. 

* * * 


На этом позвольте мне завершить описание вопросов программирования 
в операционных системах Упдо\з. Надеюсь, что представленный вашему 
вниманию материал поможет решить многие повседневные проблемы при 
разработке современного программного обеспечения. Основываясь на соб- 
ственном опыте, я постарался рассказать о наиболее интересных и важных 
темах, мало освещенных в других изданиях. Хочется верить, что эта книга 
будет востребована как начинающими, так и профессиональными програм- 
мистами. Желаю всем читателям никогда не останавливаться на достигну- 
том, поскольку только так можно добиться настоящего успеха. 


ПРИЛОЖЕНИЕ 


Описание компакт-диска 


Прилагаемый к книге диск содержит исходные коды всех примеров и сис- 
темные драйверы для работы с аппаратными портами ввода-вывода. Приме- 
ры расположены в каталоге Ехатрез, а драйверы — в Омуег$. Нумерация 
примеров совпадает с соответствующими номерами листингов. Выбор драй- 
вера зависит от установленной операционной системы: для УЛшдо\з 9х/МЕ 
предназначен [о32роц.ух4, а для \УМпдо\з М№Т/2000/ХР/$ КЗ — 1Юизегу.5уз. 
Чтобы использовать драйвер, достаточно скопировать его в папку с проек- 
том, в его свойствах снять атрибут “только для чтения" и добавить в свой 
проект код класса стоз2 или стоз2мт, описанный в ги. [. 


Просмотр диска осуществляется только в ручном режиме: 

1. Вставьте диск в устройство чтения. 

2. Откройте папку Мой компьютер (Му Сотрщег). 

3. Выберите устройство чтения компакт-дисков и откройте его. 


Хочу обратить ваше внимание, что предлагаемые системные драйверы 
предназначены только для тестирования примеров из данной книги и не 
должны быть использованы как-либо иначе. 
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С АСР (Ассаегаеа СОтарШс$ Ром) — специально выделенный высокоско- 
ростной порт для наилучшей передачи графических трехмерных данных 
от видеоадаптера в системную память. 


С АМТ (Атепсап Мабопа! ${апдаг4$ шзНиие) — негосударственная амери- 
канская организация, определяющая различные стандарты для необяза- 
тельного применения. 


С АРГ (АррИсаНоп Ргоргаттие Пице{асе) — прикладной интерфейс про- 
граммирования, предоставляющий низкоуровневые средства доступа к 
ресурсам базовой системы (например, операционной). 


С АЗСП (Атепсап З{апдага Соде юг шюогтаНноп Пиегсвап?е) — стандарт- 
ный американский код для обмена информацией, выполняющий преоб- 
разование символов в цифровую форму. 


С АТА (АТ Айцасбтеп — интегрированная шина обмена данными между 
дисковой подсистемой и процессором, используемая наряду с 1ЮЕ. 


0 АТАРГ (АТ Ацасптепе РасКе! Пиег се) — набор программных и аппарат- 
ных ресурсов, описывающих интерфейс (на базе шины АТА) между про- 
цессором и устройствами чтения (записи) компакт-дисков. 


0 ВГО$ (Ваяс шри/Ошфи Зумепт) — базовая система ввода-вывода, осу- 
ществляющая низкоуровневый доступ к аппаратным ресурсам системы. 


П СОЕ$ (Сотрасе О15с Ее Зумет) — файловая система, разработанная для 
представления и доступа к данным на компакт-диске. 


О СО-ВОМ (Сотрасе О15с КВеад-ошу Метогу) — оптическое постоянное 
устройство хранения данных, доступных только для чтения. 


П Ст$№ (Са$ 14епийег) — универсальный уникальный идентификатор 
для определения объекта ОГЕ. 


О СОМ (Сотропем ОБесе Моде!) — объектная модель для независимого 
многоуровневого представления различных системных и определяемых 
пользователем компонентов. 
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ООС (О15рау Ома Сваппе!) — канал обмена данными между дисплеем и 
видеоадаптером. 


ООК (Оеусе Опуег Ки) — набор программных компонентов для разра- 
ботки драйверов. Для разных версий \У/п4о\$ имеются собственные па- 
кеты разработчика драйверов. 


ОТВ (Оемсе-ш4ереп4епе В тар) — формат графического представления 
растровых изображений в виде, не зависимом от устройства отображе- 
ния. Другими словами, любая графика в этом формате будет одинаково 
выглядеть на различных системах. 


ОМ. (Бупапс Мак 16гагу) — двоичный тип файла, динамически загру- 
жаемый по мере необходимости в область памяти вызывающей програм- 
мы. Он используется в первую очередь для разделения ресурсов и про- 
граммных интерфейсов, тем самым уменышая размер исполняемого 
файла. 


ОМА (ПОиесЕ Метогу Ассез$) — прямой доступ к памяти, позволяющий 
устройству передавать или получать данные без участия процессора, что 
значительно экономит время и системные ресурсы. 


ОРМ$ (О!5рИау Ро\ег МапасетепЕ $12па|п?) — стандарт управления пи- 
танием дисплея. 


ОЗР (Пирна| $1епа! Ргосез5ог) — цифровой сигнальный процессор, пред- 
назначенный для цифровой обработки при высокоскоростной передаче 
данных. Наиболее часто применяется в устройствах связи и звуковых 
платах. 


ЕСР (Ежепаеа Сара ШЧе$ Ром) — асинхронный 8-разрядный канал для 
параллельной передачи данных от компьютера на устройство и обратно. 


ЕАТ (Е|е АНосаноп Та Ме) — таблица размещения файловых объектов на 
носителе, позволяющая упорядочить хранение и доступ к данным. 


ЕОС (Рорру 415К Опуе СогигоПег) — контроллер накопителя на гибких 
дисках. 


ЕТР (Ее ТгапзЁег Ргоюсо]) — протокол передачи файлов из сети на ком- 
пьютер и обратно посредством ТСР/Р. 


СОТ (Софа!у Чшаие 4епийег) — уникальный глобальный идентифи- 
катор, представляюший собой 16-байтное значение, гарантирующее кор- 
ректный доступ к указанному объекту в операционной системе. 


НСО (Нох СопиоПег Опмег) — устройство ведушего контроллера. В кон- 
тексте шины УЗВ оно предназначено для задающего устройства управ- 
ления чипсетом периферийного оборудования. 


НСТ (Ноз СопигоЦег Ицегсе) — интерфейс ведущего контроллера, ис- 
пользуемый на шине ЦЗВ. 
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П НОС (Нага Ок ШО Сопеойег) — контроллер ввода-вывода жесткого 
диска. 


П НГО (Нитап Пие асе Оеусе) — интерфейс устройства, используемого на 
шине ОЗВ. 


О НТТР (Нурепехе ТгапзЕег Ргоосо!) — протокол Интернета, используемый 
браузерами и серверами для обмена информацией. 


О ВС (Гиег-Пцергмед Сисий Ви$) — последовательная шина передачи дан- 
ных по двум проводам (синхронизация и данные). 


П ©МР (Ииегше Сопго! Меззаре Рго!осо!) — расширение протокола [Р для 
передачи данных, поддерживающих генерацию сообщений об ошибках, 
тестовых пакетов и информационных сообщений. 


О ШЕ (Гиергиеда Ое\мсе Еесгоп1с$) — дисковое устройство хранения дан- 
ных с интегрированным контроллером. 


П ПО Ишейасе 1депийег) -- уникальный глобальный идентификатор, свя- 
занный с определенным интерфейсом. 


О ТР (!иеше Ргокосо!) — базовый протокол Интернета, позволяющий пе- 
редавать пакеты данных от одного хост-компьютера к другому. 


П ГСО (Госае ШЧепийег) — идентификатор (32-разрядный) языка для пра- 
вильного отображения информации. 


О М (МиясаЕ ш$гитепе Оуэна! Пие асе) — цифровой интерфейс опи- 
сания музыкальных инструментов, позволяющий с помощью компьютера 
управлять различными музыкальными устройствами. 


О ММГ (Моптпазкае Ицеггир() — немаскируемое прерывание. Данный тип 
прерывания является приоритетным и не может быть аннулирован дру- 
гим запросом на обслуживание. 


С ОГЕ (ОБес+ ГлиКш$ апа Епбеа4 и?) — технология, позволяющая встраи- 
вать внешние (принадлежащие другим приложениям) объекты в собст- 
венную программу. 

П РСГ (РепрНега! Сотропепе Пцегсоппес — межкомпонентная 32- или 
64-разрядная шина, объединяющая различные устройства. 


О РЕ (Ргоргатта Ме ЦиеггарЕ СошгоПег) — программируемый контроллер 
прерываний. 

О РОЗТ (Ромег-Оп Зе-Тез) — самотестирование компьютерной системы 
после включения питания, инициируемое ВТО$. 


О $МТР (5ппре Май Тгапзг Ргоосо!) — стандартный протокол Интерне- 
та для передачи электронной почты. 


О $УСА (Зирег УСА) — стандарт дисплея с высоким разрешением (не ме- 
нее 1024 х 768) и качеством изображения. 
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О ТСРЛР (Тгапутизяюй Сопго! Ргоосо/Циегпе! Ргоосо!) — набор стан- 
дартных транспортных протоколов для Интернета, состоящий из сле- 
дующих компонентов: ТСР, [Р, ОБР и СМР. 


П ОЮОР (О5ег Омжазгат Рго!осо|) — транспортный протокол без установки 
соединения, формирующий интерфейс пользователя для протокола [Р. 


П 9ВЬ (ЧшЮпл Кезошсе [4епНЙег) — идентификатор ресурса, используе- 
мый в глобальной сети. 


0 93В (Чтуегза| Зена! Виз) — универсальная последовательная шина, под- 
держивающая двунаправленный обмен данными и динамическое под- 
ключение (при включенном питании компьютера) устройств. 


О УСА (\У!4ео Старыс$ Агау) — стандарт дисплея, поддерживающего раз- 
решение цветного экрана не менее 640 х 480 пикселов. 


О \т32 АРГ— прикладной 32-разрядный интерфейс программирования 
для всех операционных систем УЛп4о\5. 


Список литературы 
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Диалог: 
© выбора каталога 651 
$ для открытия файлов 658 
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Звуковая плата: 
Ф интерфейс МП 256 
$ микшер 245 
© порт: 
“ 2х4р 245 
в 2х5| 245 
9 2х6р 234 
° 2хАН 236 
ве 2хСр 237 
о 3001 256 
о 3301256 
Ф процессор ОЗР 238 
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Интерфейс: 
осНо$Л Нап ег 740 
1ОеСйетие 740 
1Ое1аР!асеРгате 740 
1Ое1тР!асеЗ ие 740 
[Рег ЕШе 671 
[5Вешлик 671 

[Зтогаве 740 

ГОпКпо\п 740 
ГУ/е6Вго\иег2 755 
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Команды: 
$ для клавиатуры: 
< АВВ 97 
< АБ 99 
о АЕБ 99 
« ЕЛЬ 100 
< ЕЕК 102 
° ЕВ 102 
ЕЗВ 105 
9 для мыши: 
РузаЫе 60 
ЕраЫе 60 
Веад Рима 64 
Кеад Ремсе Туре 63 
Кезепа 60 
< Кезе 58 
° Везе \/гар Моде 64 
= 5е ОегаиН$ 60 
= 5@ Кетое Моде 63 
< 561 КезошНоп 68 
° 52 ЗатрЕе Кае 61 
о 5е ЗсаНие 1:1 69 
в $ ЗсаНие 2:1 69 
о $ Зхеат МоЧе 64 
° 5е У!гар Моде 63 
о За Кедиез1 64 
Команды управления: 
Ф для АТА/АТАРИ 412 
о СНЕСК РО\/ЕК МОРЕ 414 
° РЕ\МСЕ ВЕЗЕТ 417 
 ЕХЕСОТЕ РЕМСЕ РАСМОЗТС 418 
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Команды управления (прод.): 


о 


Контроллер прерываний, команда: 


еееоеое<е>< 


для АТА/АТАРИ (прод.): 
ЕЦОЗ$Н САСНЕ 419 
ШЕМТЕРУ ОЕМСЕ 420 


ТОГЕ 427 

ТРЕЕ 1ММЕГЛАТЕ 428 
МОР 430 

РАСКЕТ 430 

ВЕАРО ОМА 433 

ВЕАО МОГЛРГЕ 433 
ВЕАО $ЕСТОВ ($) 434 


ЗГЕЕР 438 

М\МТЕ 5ЕСТОК ($) 438 
для флоппи-дисковода 387 
ЕОВМАТ ТКАСК 399 
ВЕАО ПОАТА 390 

КЕАО ОЕГЕТЕО РАТА 397 
ВЕАО О 405 

КЕАО ТКАСК 399 
ВЕСАЦВКАТЕ 401 

ЗЕЕК 404 

ЗЕМЗЕ ОЩМУЕ $ТАТО$ 404 


ооосооососоосоосоо 


УЕВГЕУ 399 
\ЕТЕ БАТА 397 
\ЕТЕ ОЕГЕТЕО ВАТА 399 


оооосовсв ово от 


1С\1 497 
1С\/?2 497 
1С\?3 497 
1С\/4 498 
ОС\Т 498 
ОС\/2 499 
ОСУ\З 499 


Макрокоманда: 


[> >>> >>> 22 26- 


А\У!бисатЕп4Типе 214 
МСГ\М!паСюзе 204 
МСИ\пар,езгоу 204 
МОГ! пабеоот 213 
МСГ\паНоте 204 
МСГ\/паРацзе 204 
МСГ\!паР!у 204 
МСП\п4Везите 204 
МСГ\пазеХоот 213 
МСГ\па$юр 204 


ПРЕМТТРУ РАСКЕТ ОЕМ!СЕ 424 


ВЕАО УЕНЕРУ $ЕСТОВ ($) 437 


ЗЕМ$ЗЕ ПИМТЕВКОРТ $ТАТИ$ 402 


Память СМО$ 323 
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пи 101, функция: 


ообоообоосо осо оо оо оо о о ово оо вов оо ооо ооо осо оо ооооосоо 


00Н 123 
О1Ь 124 
026 125 
03В 126 
056 126 
Обн 127 
076 129 
086 130 
096 131 
ОАБ 132 
овООН 132 
ОВО 133 
ОСЬ 134 
оО 134 
ОЕР 135 
ОЕВ 136 


10008 139 


1001 139 
10028 139 
1003Ь 140 
1007Ь 140 
10081 140 
1009Н 141 
10108 141 
10128 141 
10138 142 
10156 143 
1ОТ7Ь 143 
ГОТАВ 144 
ТО1ВЕ 144 
11008 144 
12306 136 
12316 137 
1232 138 
12361 138 
1А00Н 145 
4РО0В 148 
4ЕОТЬ 150 
42028 155 
4ЕОЗЬ 156 
4Е04Ь 157 
42056 158 
4Е06В 158 
4ЕО7Ь 159 
4Е08В 161 
4Е09В 161 
4РОАВ 162 
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© п 131, функция: о 02.86 
о 001342 ° 03687 
е 010344 о 04689 
026344 ° 05589 
° 036345 о 09190 
° 046346 в ОА 92 
о 056347 о 1092 
о 086 348 о 11692 
09349 ° 12493 
(Си 349 < 20694 
в 001350 о 21194 
о 101351 ° 22494 
о 116351 о БЕБ 95 
а 148352 Ф ии 175, функция: 
156352 00551 
° 161352 в (11552 
о 171353 026552 
с 181 354 © пи ТАН, функция: 
о 41357 = 00327 
° 42.358 = 01327 
° 436 359 = 026328 
о 446360 = 036328 
456361 = 046329 
° 461362 = 051330 
° 476363 = 06330 
со 486363 = 070330 
° 491372 $ ии 801, функция: 
° 4АБ 378 00004 229 
= 4В6 379 = 00011229 
= 4С6 379 = 0002, 229 
о 426372 00031 229 
о 501 373 ° 00041230 
“ 521 376 = 00051230 
$ шЕ 141, функция: о 00061231 
о 00553 ° 00074231 
о 011555 = 00088 231 
° 028555 " 0009232 
о 031556 =" 000АВ 232 
© ии 151, подфункции: Протокол: 
о 0044 Ф РОРЗ 786 
о 01145 © ЭМТР 779 
° 02.46 Процессор ОЗР, команда: 
° 03147 $ 10Н 240 
о 04148 © 141 240 
" 05148 © 161 240 
о 06149 о 178 240 
з 0750 о 201 240 
э 08851 © 301 241 
° 051 0 38Н 241 
© ит 161, функция: о 401 241 
° 00.82 0 418 241 
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Процессор ОЗР, команда (прод.): 
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421 242 
4811 242 
808 242 
АОН 242 
АТ 242 
010 242 
031 243 
ОВ 243 
Е11 243 


Р 


Регистры: 


Ф 


АТА/АТАР1 406 

е дополнительный регистр состояния 411 

" регистр выбора устройства и номера 
головки 409 

" регистр данных 408 

" регистр команд 411 

" регистр младшего байта номера цилиндра 

409 

регистр номера сектора 409 

регистр особенностей 408 

регистр ошибок 408 

регистр прерывания 409 

регистр состояния 410 

регистр старшего байта номера цилиндра 

409 

® регистр счетчика секторов 409 

регистр управления 411 

видеоконтроллера 162 

внешние регистры 163 

второй регистр состояния 165 

первый регистр состояния 165 

регистр особенностей 165 

регистры графического контроллера 167 

регистры контроллера СКТ 178 

регистры контроллера атрибутов 174 

регистры общих настроек 164 

регистры палитры 175 

регистры синхронизатора 190 

регистры ЦАП 188 

контроллера ОМА 487 

флоппи-дисковода: 

" дополнительный регистр состояния 381 

* основной регистр состояния 384 

“ регистр данных 387 

° регистр управления конфигурацией 387 

° регистр управления лентопротяжным 
механизмом 383 

" регистр управления скоростью передачи 
данных 385 


овоооо 


ооосвооосовсво 
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" регистр цифрового ввода 387 
° регистр цифрового вывода 382 


С 


Создание ярлыка 671 
Структура: 

© Почем 790 

ГОСЕОМТ 577 
РКОСЕ$ЗЕМТВУЗ2 676 
КАЗОЕУПМЕО 738 
КАЗП1АГРАКАМ$ 738 
КАЗЕМТВУ 738 
зоскад4г_т 786 
ТНВЕАОЕМТКУЗ2 676 


Ф 


Формат: 
$ МИГ 294 
© МР?З 301 
Функции РС В10$ 465 
В1011 466 

В1028 466 

В1031 468 

В106' 468 

В108В 469 

В109 470 

В1ОАВ 471 

ВтОВЬ 472 

В10СТ 473 

Вто 473 
ункция: 

_Вореп 705 

ар 16, 17 
АспуаеКеубоагаТауоц: 118 
АУТЕЕхи 214 

АУГЕйеви 213 
А\УиеапОетЕтате 214 
АУ! исатОеЕтатеСюзе 214 
А\У!Зисат@ОеЕтатеОреп 214 
АУ[5иеат шЮ 214 

АУ! Зиеат [епёЕ 214 

АУ ЗтеатОрепЕгот Ейе 214 
А\У[5исатвВеа4 214 
А\У!5иеатВе[еазе 214 

Ыпа 795 

ВосКприе 73 
СрапееОвр!аузеипвз 197 
сюзезосКее 786 

СоСтеае шчапсе 671 


ееееоое$есе>< 


О-В 
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Сопииа|те 671 

соппест 786 

СоруЕИе 689 
СоЦишайте 671] 
СтежеОнесогу 689 
СтежмеЕИе 685 
Стсае Роп пайест 576 
СтежезоНаВгазй 579 
СтсаеТоое!р32$рарзпой 676 
СтурЕАсаниеСощехе 731 
СтурЕСтежеНазВ 731 
СтурОесгур! 731 
Сгур)ОепуеКеу 731 
СтурОезноуНаз1 731 
Стур)езноуКеу 731 
СтурЕпстур! 731 
Стур!ЕхропКеу 731 
СтгурСепКеу 731 
Стур@е ОзегКеу 731 
Стур( Нап Ожа 731 
СтурИтроиКеу 731 
СтурКе!еазеСощех( 731 
естурИЕИе 721 
РеееР\1е 689 
РевеОест 578 
Оемсе!оСопио! 20 
там \ЬСюзе 214 
ОгамО®Ога\м 214 
ОтамО\БОреп 214 
Епсгур(ЕЙе 720 
ЕпсгурНоп О15аЫе 721 
Епит О1вр!аузе тез 195 
{её 709 

ПизВ 708 

ас 708 

Ве 710 
ЕйеЕпстурпоп “ати 720 
Ен9С10$е 695 

ЕшаЕиз Ее 695 
ЕшаМежЕйЙе 695 
НизВРИсВийе1з 698 
Юрсп 704 

рип 711 

рис 708 

риб 710 

Неа 706 

Бсайё 711 

Кеек 708 

Ве! 708 

Ербе!Ейе 777 
ИрбеЕ|еб ше 777 
НИр$е Сите Онестоту 777 
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Кугце 706 
СеСагеВНакТипе 113 
СеСотргеззеаРЦе$ те 702 
СеСитет Онескюоту 698 
СеСипетиРгосез$14 679 
Сее\мсеСарз 199 
СеНо$КЕтеебрасеЕх 699 
СеоцЫеСПскТите 71 
ОеОпуеТуре 700 
СеЕхрап4е4 Мате 714 

Се ЕЙеАинЬисз 697 
СеЕПеб те 701 
СеРИеЗтеЕх 701 
СегКеубоатАГауош 119 
СаКеубоагАГ ауои Мате 119 
Се ОрепЕЙеМате 666 
СеЗуцетМелс$ 71, 74 
Нар_Седнньшез 865 
Нар_СеЕеаштс 866 
Нэао_СеНабич 865 
НарО_СеМапи@сигеготае 865 
Нар_Се!РтеразеаОаа 865 
Нар)_СеРтодисе ие 865 
Нар_СебепаИ\Митбег5 ия 865 
Нао_5е!{Реаште 866 
НирОиегушЮ 777 

1СС!юзе 225 

1СПБесотргез$ 225 
[СОесотргез$Ореп 225 
пиСоттопСотто!5 Ех 609 
ПиегпеАнетриСоппесЕ 768 
пиегоеС]озеНап4е 777 
Пиегпе(Соппеси 777 
Пиегпе Се Соппемед $ же 768 
Пиегпе!Ореп 768 
ПкетиеОреп т! 777 
Нистпе(ВеааЕЦе 777 
ГоадАссеегакот$ 115 
ГоааСигзог 77 
ГоадКеубоагаТауои" 118 
ГосКкЕИе 687 

Е7Сюзе 714 

[7Сору 714 

[7.ОрепЕЙе 714 

Е7Веа4 714 

Е75еек 714 

шо ЗепаСоттана 279 
пс1Зепа$ тия 296 
МС!\МпаСгеас 205 
пихегСюзе 262 
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Функция (прод.): 
пихегое(СопиоОеаЦ$ 262 
тхегОе!{ОеуСарз 262 
пихегсейо 262 

пихегСе теСопиго!5 262 
пихегое тетю 262 
пихегОеМитОеуз 262 
пихегОреп 262 
пухегЗе(СопгоДеай$ 262 
МоуеРИе 689 

ОрепТвгеаа 683 
ОшриОеБи» тая 790 

Роз Меззаве 201 
Ргосе$$32Е из 676 
Ргосез$32 Мех 676 
КВазЕпитОемсез 738 
Каззе ЕпиуО а! Рагапа$ 738 
КаззеЕпиуРгореи1ез 738 
КазУа|!4аеЕигуМате 738 
КеаЧЕйе 685 

гесу 786 

ВермегНо{Кеу 116 
ВегОрепКеуЕх 806 
КегОцегуУаюеЕх 807 
ВетоуеОнестогу 689 

зепа 786 

З&ВкСо|ог 579 
Зе{СагеВпиКТипе 113 

Зе СоогМазК 224 
ЗеСштенОнестогу 698 

Зе Сиизог 77 

Зе Оои еС!сКТите 71 
ЗеаЕЦеАнньщез 697 

Зе ЕИеРопиег 688 

Зе ауегеЧУЙп4омАнтьщез 829 
ЗеРногиуС!а$5 679 

Зе ТехСо[юог 579 
ЗеТИтеааРнойу 683 
ЗешрОТЕпит ЭемсеПиеНасез 865 
ЗеирОЮеОемсеПиеасеОаай 865 
Зенио Се С1а$Оеуз 865 
$НВго\мзеЕРогЕо!4ег 653 
Зпе!Ехесше 649 
$Н@еРайЕгот 0145 653 
$Н@ересла! ЕоегГосаНоп 653 
зпомСшеог 77 

зоске! 786 
$марМоизеВийоп 70 
ЗуметРагатеет$ шЮ 71, 72, 112 
ТегитаеРгосез$ 681 
ТегтшаеТгеа4 683 
Тргеа932 Риз 676 
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Тргеа932 Мехе 676 
ТгапаеАссеега‘ог 115 
ЧмоааКеубоагаТауощ 118 
ОпюскРИе 687 
ОмезщегНоКеу 116 
УлиеЕИе 685 
У!'ЗАА5упсСе(Но${ВуМате 790 
\/ЗАСапсе!АзупсВеаиез! 790 
УЗАС!еапир 786 

У’ЗА$иапир 786 


Ш 


Шина РСТ 451 


о 
о 


регистр адреса 474 
регистр данных 475 


Э 


Элементы управления: 


о 


дополнительные 609 

древовидный список 611 

инициализация 609 

использование древовидного списка 626 

окно свойств 635 

работа со списком просмотра 634 

создание окна свойств 641 

список просмотра 628 

стандартные 576 

° добавление значков в список 594 

изменение цвета кнопки 580 

з изменение цвета поля редактирования 
,591 

° изменение цвета раскрывающегося 
списка 585 

изменение цвета списка 593 

2 изменение цвета текста 578 

" изменение цвета текста для статического 
элемента 600 

о изменение цвета фона линейки прокрутки 

599 

изменение шрифта 577 

кнопка 576 

линейка прокрутки 599 

отображение скрытого пароля 592 

перетаскивание файлов в список 598 

поле редактирования 591 

преобразования статического элемента 

601 

" раскрывающийся список 585 

з список 593 

° статический элемент 600 
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